README 1.5 KB

123456789101112131415161718192021222324252627282930313233
  1. Free Pascal XML units
  2. ---------------------
  3. DOM:
  4. Implements most of the DOM level 1 specification and supports some of the
  5. DOM level 2 extensions.
  6. XMLRead:
  7. Provides a simple XML reader, which can read XML data from a file or stream.
  8. This simple parser will be replaced by a much improved one soon, which will be
  9. able to handle different character encodings, namespaces and entity references.
  10. (This parser reads the file directly, i.e. it doesn't support Unicode or
  11. different charsets yet.)
  12. Regarding entity references: The pre-defined entities "lt", "gt", "amp", "apos"
  13. and "quot" are replaced by their normal value during reading. Other entity
  14. references are stored as TDOMEntityReference nodes in the DOM tree.
  15. Regarding whitespace handling: Whitespace directly after the beginning of a
  16. tag is discarded, and sections of the XML file which contain only whitespace and
  17. no other text content are discarded as well.
  18. XMLWrite:
  19. Writes a DOM structure as XML data into a file or stream. It can deal both with
  20. XML files and XML fragments.
  21. At the moment it supports only the node types which can be read by XMLRead.
  22. Please note that the writer replaces some characters by entity references
  23. automatically:
  24. For attribute values, '"' gets replaced by '"', and '&' gets replaced by
  25. '&amp'. For normal text nodes, the following replacements will be done:
  26. '<' => '&lt;'
  27. '>' => '&gt;'
  28. '&' => '&amp;'
  29. The XML reader (in xmlread.pp) will convert these entity references back to
  30. their original characters.