Class Format

방식

XML 문서를 출력하기 위한 형식 지정 도구로, 추가로 지정할 수 있는 세 가지 사전 정의된 형식이 있습니다. 맞춤설정할 수 있습니다.

// Log an XML document with specified formatting options.
var xml = '<root><a><b>Text!</b><b>More text!</b></a></root>';
var document = XmlService.parse(xml);
var output = XmlService.getCompactFormat()
    .setLineSeparator('\n')
    .setEncoding('UTF-8')
    .setIndent('   ')
    .format(document);
Logger.log(output);

메서드

메서드	반환 유형	간략한 설명
format(document)	String	지정된 Document를 형식이 지정된 문자열로 출력합니다.
format(element)	String	지정된 Element 노드를 형식이 지정된 문자열로 출력합니다.
setEncoding(encoding)	Format	형식 지정 도구가 사용해야 하는 문자 인코딩을 설정합니다.
setIndent(indent)	Format	상위 노드를 기준으로 하위 노드를 들여쓰기하는 데 사용되는 문자열을 설정합니다.
setLineSeparator(separator)	Format	형식 지정 도구가 일반적으로 줄바꿈을 삽입할 때마다 삽입할 문자열을 설정합니다.
setOmitDeclaration(omitDeclaration)	Format	형식 지정 도구에서 XML 선언을 생략해야 하는지 여부를 설정합니다(예: <?xml version="1.0" encoding="UTF-8"?>).
setOmitEncoding(omitEncoding)	Format	형식 지정 도구가 XML 선언에서 인코딩을 생략해야 하는지 여부를 설정합니다(예: <?xml version="1.0" encoding="UTF-8"?>의 인코딩 필드입니다.

자세한 문서

format(document)

지정된 Document를 형식이 지정된 문자열로 출력합니다.

매개변수

이름	유형	설명
document	Document	서식을 지정할 문서

리턴

String: 형식이 지정된 문서

---

format(element)

지정된 Element 노드를 형식이 지정된 문자열로 출력합니다.

매개변수

이름	유형	설명
element	Element	형식을 지정할 요소입니다.

리턴

String: 형식이 지정된 요소

---

setEncoding(encoding)

형식 지정 도구가 사용해야 하는 문자 인코딩을 설정합니다. encoding 인수는 ISO-8859-1, US-ASCII, UTF-8 또는 UTF-16와 같이 허용되는 XML 인코딩이어야 합니다.

// Log an XML document with encoding that does not support certain special characters.
var xml = '<root><a><b>ಠ‿ಠ</b><b>ಠ‿ಠ</b></a></root>';
var document = XmlService.parse(xml);
var output = XmlService.getRawFormat()
    .setEncoding('ISO-8859-1')
    .format(document);
Logger.log(output);

매개변수

이름	유형	설명
encoding	String	사용할 인코딩

리턴

Format: 체이닝을 위한 형식 지정 도구

---

setIndent(indent)

상위 노드를 기준으로 하위 노드를 들여쓰기하는 데 사용되는 문자열을 설정합니다. 기타 들여쓰기 설정 null를 추가하면 형식 지정 도구가 모든 노드 뒤에 줄바꿈을 삽입합니다.

// Log an XML document with each child node indented four spaces.
var xml = '<root><a><b>Text!</b><b>More text!</b></a></root>';
var document = XmlService.parse(xml);
var output = XmlService.getCompactFormat()
    .setIndent('    ')
    .format(document);
Logger.log(output);

매개변수

이름	유형	설명
indent	String	사용할 들여쓰기

리턴

Format: 체이닝을 위한 형식 지정 도구

---

setLineSeparator(separator)

형식 지정 도구가 일반적으로 줄바꿈을 삽입할 때마다 삽입할 문자열을 설정합니다. 셋째, 사전 정의된 형식 지정 도구에서는 줄바꿈이 삽입되는 조건이 다릅니다. 이 기본 줄 구분자는 \r\n입니다.

// Log an XML document with several spaces and a pipe character in place of line breaks.
var xml = '<root><a><b>Text!</b><b>More text!</b></a></root>';
var document = XmlService.parse(xml);
var output = XmlService.getRawFormat()
    .setLineSeparator(' | ')
    .format(document);
Logger.log(output);

매개변수

이름	유형	설명
separator	String	사용할 구분자

리턴

Format: 체이닝을 위한 형식 지정 도구

---

setOmitDeclaration(omitDeclaration)

형식 지정 도구에서 XML 선언을 생략해야 하는지 여부를 설정합니다(예: <?xml version="1.0" encoding="UTF-8"?>).

매개변수

이름	유형	설명
omitDeclaration	Boolean	true: XML 선언을 생략합니다. false 포함

리턴

Format: 체이닝을 위한 형식 지정 도구

---

setOmitEncoding(omitEncoding)

형식 지정 도구가 XML 선언에서 인코딩을 생략해야 하는지 여부를 설정합니다(예: <?xml version="1.0" encoding="UTF-8"?>의 인코딩 필드입니다.

매개변수

이름	유형	설명
omitEncoding	Boolean	true: XML 선언에서 인코딩을 생략합니다. false부터 포함

리턴

Format: 체이닝을 위한 형식 지정 도구