(Delphi DLL) XML Document References

This example demonstrates the fact that the entire XML document remains in memory if at least one node is referenced. (It does not need to be the root node.)

Chilkat for Delphi Downloads Chilkat non-ActiveX DLL for Delphi Chilkat ActiveX DLL for Delphi * The examples here use the non-ActiveX DLL.

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Xml;

...

procedure TForm1.Button1Click(Sender: TObject);
var
xml: HCkXml;
success: Boolean;
xB: HCkXml;

begin
xml := CkXml_Create();

success := CkXml_LoadXml(xml,'<a><b>BBB</b><c>CCC</c></a>');

Memo1.Lines.Add(CkXml__getXml(xml));

// We have the following XML stored in memory:

// 	<?xml version="1.0" encoding="utf-8"?>
// 	<a>
// 	    <b>BBB</b>
// 	    <c>CCC</c>
// 	</a>

// Get a reference to the 1st child.
xB := CkXml_GetChild(xml,0);

// Re-load "xml" with an entirely new document:
success := CkXml_LoadXml(xml,'<z><x>XXX</x></z>');

// What happens to xB?
// The answer is nothing.  xB still points ot the "b" node in the original document, and the entire
// original document remains in memory.  We now have two XML documents in memory.

Memo1.Lines.Add(CkXml__getXml(xB));

// output is:

//     <b>BBB</b>

// Make xB reference the root node of its document:
CkXml_GetRoot2(xB);
Memo1.Lines.Add(CkXml__getXml(xB));

// You can see here that the entire original XML document is still available
// because at least one node in the XML is referenced by a variable.
// The output is:

//     <?xml version="1.0" encoding="utf-8"?>
//     <a>
//         <b>BBB</b>
//         <c>CCC</c>
//     </a>

// We can also see that "xml" contains an entirely new XML document:
Memo1.Lines.Add(CkXml__getXml(xml));

//     <?xml version="1.0" encoding="utf-8"?>
//     <z>
//         <x>XXX</x>
//     </z>
// 

CkXml_Dispose(xB);

CkXml_Dispose(xml);

end;