Class XML

core/src/processing/data/XML.java:52–1157

This is the base class used for the Processing XML library, representing a single node of an XML tree. @webref data:composite @see PApplet#loadXML(String) @see PApplet#parseXML(String) @see PApplet#saveXML(XML, String)

 * @see PApplet#saveXML(XML, String)
 */
public class XML implements Serializable {

  /** The internal representation, a DOM node. */
  protected Node node;

//  /** Cached locally because it's used often. */
//  protected String name;

  /** The parent element. */
  protected XML parent;

  /** Child elements, once loaded. */
  protected XML[] children;

  /**
   * @nowebref
   */
  protected XML() { }


//  /**
//   * Begin parsing XML data passed in from a PApplet. This code
//   * wraps exception handling, for more advanced exception handling,
//   * use the constructor that takes a Reader or InputStream.
//   *
//   * @throws SAXException
//   * @throws ParserConfigurationException
//   * @throws IOException
//   */
//  public XML(PApplet parent, String filename) throws IOException, ParserConfigurationException, SAXException {
//    this(parent.createReader(filename));
//  }


  /**
   * Advanced users only; use loadXML() in PApplet. This is not a supported
   * function and is subject to change. It is available simply for users that
   * would like to handle the exceptions in a particular way.
   *
   * @nowebref
   */
  public XML(File file) throws IOException, ParserConfigurationException, SAXException {
    this(file, null);
  }


  /**
   * Advanced users only; use loadXML() in PApplet.
   *
   * @nowebref
   */
  public XML(File file, String options) throws IOException, ParserConfigurationException, SAXException {
    this(PApplet.createReader(file), options);
  }

  /**
   * @nowebref
   */