(Tcl) Benefit of XML Methods Having Names Ending in "2"

The Chilkat XML methods having names ending with "2" update the internal reference rather than return a new XML object instance. See the example below..

Note: There are a few methods, such as LoadXml2, where the "2" simply indicates the method is the same but has an additional argument. (There are some programming environments where overloading methods is not allowed. Therefore, Chilkat will avoid providing methods having the same name but with different arguments.)

Chilkat Tcl Extension Downloads Chilkat Tcl Extension Downloads

load ./chilkat.dll

set x "<test><abc><xyz>123</xyz></abc></test>"

set xml [new_CkXml]

set success [CkXml_LoadXml $xml $x]

# First demonstrate getting "123" in the simplest way:
puts [CkXml_chilkatPath $xml abc|xyz|*]

# Now demonstrate navigating to the "xyz" node using non-"2" methods.
# The following few lines of code create two object instances, which will need
# to be deleted or garbage collected.
# xAbc is a CkXml
set xAbc [CkXml_FindChild $xml "abc"]
# xXyz is a CkXml
set xXyz [CkXml_FindChild $xAbc "xyz"]
puts [CkXml_content $xXyz]
delete_CkXml $xXyz

delete_CkXml $xAbc

# Now demonstrate navigating to the "xyz" node using the "2" methods.
# No object instances are created.
set success [CkXml_FindChild2 $xml "abc"]
set success [CkXml_FindChild2 $xml "xyz"]
puts [CkXml_content $xml]
# Restore xml back to the root of the document.
CkXml_GetRoot2 $xml

delete_CkXml $xml