toXmlString method

String toXmlString(
  1. {bool pretty = false,
  2. XmlEntityMapping entityMapping,
  3. int level,
  4. String indent,
  5. String newLine,
  6. Predicate<XmlNode> preserveWhitespace,
  7. Predicate<XmlAttribute> indentAttribute,
  8. Comparator<XmlAttribute> sortAttributes}

Return a default XML string of this object. Return an XML string of this object.

If pretty is set to true the output is nicely reformatted, otherwise the tree is emitted verbatim.

The entityMapping defines how character entities are encoded into the resulting output.

All other options are used for pretty printing only:

  • The option indent defines the indention of nodes, by default nodes are indented with 2 spaces.
  • The option newLine defines the printing of new lines, by default the standard new-line '\n' character is used.
  • The option level customizes the initial indention level, by default this is 0.
  • If the predicate preserveWhitespace returns true, the whitespace characters within the node and its children are preserved by switching to non-pretty mode. By default all whitespace is normalized.
  • If the predicate indentAttribute returns true, the attribute will be begin on a new line. Has no effect within elements where whitespace are preserved.
  • If the sortAttributes is provided, attributes are on-the-fly sorted using the provided Comparator.


String toXmlString({
  bool pretty = false,
  XmlEntityMapping entityMapping,
  int level,
  String indent,
  String newLine,
  Predicate<XmlNode> preserveWhitespace,
  Predicate<XmlAttribute> indentAttribute,
  Comparator<XmlAttribute> sortAttributes,
}) {
  final buffer = StringBuffer();
  final writer = pretty
      ? XmlPrettyWriter(buffer,
          entityMapping: entityMapping,
          level: level,
          indent: indent,
          newLine: newLine,
          preserveWhitespace: preserveWhitespace,
          indentAttribute: indentAttribute,
          sortAttributes: sortAttributes)
      : XmlWriter(buffer, entityMapping: entityMapping);
  return buffer.toString();