DomExt: what changed

Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	1		### \[This entry is obsolete but kept for documentation. Simply use fcl-xml from the standard packages.\]
2	2
3	3		### About
4	4
5	5		DomExt unit extends FPC implementation of XML DOM API with set of functions to simplify XML node manipulation. Its functionality is inspired by [SimpleXML Library by Michael Vlasov](http://www.torry.ru/authorsmore.php?id=4012)
6	6
7	7		Its main characteristics are:
8	8
9	9		- Type conversion when working with node and attribute values. E.g. DomReadIntAttr returns attribute value as Integer. This is similar to TIniFile API. Supported data types include String, Integer, Boolean, Double and TDateTime. Non-string data types are coverted to string representation using [XSD primitive data types syntax](http://www.w3.org/TR/xmlschema-2/#built-in-primitive-datatypes).
10	10		- Handling default node and attribute values when reading, similar to TIniFile API.
11	11		- Encoding conversion when working with node and attribute names and values. You may need this feature in LCL projects because FCL dom.pp uses UTF-16 (widestring) and LCL uses UTF-8.
12	12		- Flexible child node handling that helps to avoid excessive Assigned(...) checks. DomNeedChild function is guaranteed to return a non-nil node or raise an exception if requested node was not found. DomEnsureChild creates requested node if it does not exist. If you need to check node existence you can use DomGetChild that returns nil if requested child node was not found. All those functions allow to request not only direct descendant nodes but also deeply nested nodes using XPath-like syntax, e.g. 'childLevel1/childLevel2'.
13	13		- Ability to save/load StringLists to/from XML node lists.
14	14		- Ability to read/write node content as XML fragment, similar to innerHTML property in JavaScript.
15	15
16	16		### Author
17	17
18	18		Vladimir Zhirov
19	19
20	20		### License
21	21
22	22		[modified](http://svn.freepascal.org/svn/lazarus/trunk/COPYING.modifiedLGPL) [LGPL](http://svn.freepascal.org/svn/lazarus/trunk/COPYING.LGPL) (same as the FPC RTL and the Lazarus LCL).
23	23
24	24		### Download
25	25
26	26		The latest stable release can be found on link to the lazarus-ccr sf download location.
27	27
28	28		### Change Log
29	29
30	30		Version 0.1 2010-08-25
31	31
32		-	~~` * initial release`~~
	32	+	```text
	33	+	* initial release
	34	+	```
33	35
34	36		### Dependencies
35	37
36	38		The unit is a single Pascal source file that only depends on FPC RTL and FCL.
37	39
38	40		### Status
39	41
40	42		Beta
41	43
42	44		Issues:
43	45
44	46		- Since the unit was primarily written for use in LCL applications, widestring mode ("transparent", without string conversions) is completely untested. To use it one can comment out {\$define UTF8Strings} compiler directive.
45	47		- Conversion between TDateTime and String does not fully obey XSD specs, both because TDateTime limitations and implementation details. Thus, years beyond 1..9999 range, fractional seconds and time zones are not supported.
46	48
47	49		### Installation and usage
48	50
49	51		Include unit DomExt in the uses section. Set path for it in project settings if needed.
50	52
51	53		### Contact
52	54
53	55		Please send bug reports and patches to the e-mail you find in the unit source code.
54	56
55	57		---
56	58		From the Free Pascal wiki, page "DomExt", as it stood on 2017-12-15 after a change by Thaddy, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).
57	59		Category: Components

Back to history