Daha sonra izlenebilecek önceden tanımlanmış üç biçime sahip, XML belgesi çıktısı almak için bir biçimlendirici özelleştirilmiş.
// 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);
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
format(document) | String | Belirtilen Document öğesini biçimlendirilmiş bir dize olarak verir. |
format(element) | String | Belirtilen Element düğümünü biçimlendirilmiş bir dize olarak verir. |
setEncoding(encoding) | Format | Biçimlendiricinin kullanması gereken karakter kodlamasını ayarlar. |
setIndent(indent) | Format | Alt düğümlere üst düğümlerine göre girinti eklemek için kullanılan dizeyi ayarlar. |
setLineSeparator(separator) | Format | Biçimlendirmecinin normalde satır sonu eklediği zaman eklenecek dizeyi ayarlar. |
setOmitDeclaration(omitDeclaration) | Format | Biçimlendiricinin, <?xml version="1.0"
encoding="UTF-8"?> gibi XML bildirimini atlayıp atlamayacağını belirler. |
setOmitEncoding(omitEncoding) | Format | Biçimlendiricinin, XML bildirimindeki gibi kodlamayı atlamasını
kodlama alanına sahip olmak için <?xml version="1.0" encoding="UTF-8"?> biçimini kullanın. |
Ayrıntılı belgeler
format(document)
format(element)
setEncoding(encoding)
Biçimlendiricinin kullanması gereken karakter kodlamasını ayarlar. encoding
bağımsız değişkeni
ISO-8859-1
, US-ASCII
, UTF-8
veya UTF-16
gibi kabul edilen bir XML kodlaması olmalıdır.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
encoding | String | kullanılacak kodlamayı |
Return
Format
— zincirleme için biçimlendirici
setIndent(indent)
Alt düğümlere üst düğümlerine göre girinti eklemek için kullanılan dizeyi ayarlar. Diğer girinti ayarlama
değeri (null
), biçimlendiricinin her düğümden sonra bir satır sonu eklemesine neden olur.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
indent | String | kullanılacak girinti |
Return
Format
— zincirleme için biçimlendirici
setLineSeparator(separator)
Biçimlendirmecinin normalde satır sonu eklediği zaman eklenecek dizeyi ayarlar. Üç
önceden tanımlanmış biçimlendiricilerin satır sonu eklediği farklı koşulları vardır. İlgili içeriği oluşturmak için kullanılan
varsayılan satır ayırıcı \r\n
şeklindedir.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
separator | String | ayırıcı olarak |
Return
Format
— zincirleme için biçimlendirici
setOmitDeclaration(omitDeclaration)
Biçimlendiricinin, <?xml version="1.0"
encoding="UTF-8"?>
gibi XML bildirimini atlayıp atlamayacağını belirler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
omitDeclaration | Boolean | XML bildirimini atlamak için true ; Bunu dahil etmek için false |
Return
Format
— zincirleme için biçimlendirici
setOmitEncoding(omitEncoding)
Biçimlendiricinin, XML bildirimindeki gibi kodlamayı atlamasını
kodlama alanına sahip olmak için <?xml version="1.0" encoding="UTF-8"?>
biçimini kullanın.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
omitEncoding | Boolean | XML bildirimindeki kodlamayı atlamak için true ; false -
ekle |
Return
Format
— zincirleme için biçimlendirici