PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
  • XML functions and threads
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
XMLBuildString (Function)
In french: XMLConstruitChaîne
Retrieves and formats the content of an XML document. This XML document could:
  • have been created with XMLDocument and modified with the XML functions.
  • correspond to an xmlDocument variable.
WINDEV The corresponding character string can be saved as an XML file by fSaveText. Reminder: fSaveText creates a text file in ANSI format. To create a Unicode text file, use fOpen / fWrite.
Java In the final XML document, the list of attributes is sorted in alphabetical order.
Java If the XML document to format contains the declaration of an internal DTD, the description of this DTD will not be transcribed in the final XML document.
Versions 18 and later
Universal Windows 10 App This function is now available in Windows Store apps mode.
New in version 18
Universal Windows 10 App This function is now available in Windows Store apps mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
Versions 21 and later
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
WINDEVJavaUser code (UMC)
XMLSource is string
Res is boolean
// Load the XML content
XMLSource = fLoadText("example.xml")
 
// Create the XML document
Res = XMLDocument("XMLDoc", XMLSource)
 
// Modify the XML document
...
 
// Retrieve and format the XML document
XMLSource = XMLBuildString("XMLDoc")
 
// Save the XML file
fSaveText("ModifiedExample.xml", XMLSource)
Syntax

Retrieving the source of an XML document created by XMLDocument Hide the details

<Result> = XMLBuildString(<Name of the XML document> [, <Creation options> [, <Output format>]])
<Result>: Character string
Formatted XML document. This result can be:
  • handled in memory.
  • WINDEV saved in a file in XML format by fSaveText.
  • ...
<Name of the XML document>: Character string
Name of XML document to format. This document was created by XMLDocument and it was modified by the XML functions.
<Creation options>: Optional Integer constant
Combination of following values:
XMLCurrentPositionGenerates the XML code from the current position in the XML document (instead of the root).
XMLDocumentDefault
(default value)
Generates the XML code with a header and from the root.
XMLFormattingGenerates XML code with formatting (indentation and carriage returns).
XMLNoHeaderGenerates the XML code without header.
<Output format>: Optional Integer constant
Indicates the encoding used in the file header:
XMLEncodingIso8859_1Encoding according to the Latin character set
XMLEncodingIso8859_2Encoding according to Iso8859_2
XMLEncodingIso8859_3Encoding according to Iso8859_3
XMLEncodingIso8859_4Encoding according to Iso8859_4
XMLEncodingIso8859_5Encoding according to Iso8859_5
XMLEncodingIso8859_6Encoding according to Iso8859_6
XMLEncodingIso8859_7Encoding according to Iso8859_7
XMLEncodingIso8859_8Encoding according to Iso8859_8
XMLEncodingIso8859_9Encoding according to Iso8859_9
XMLEncodingIso8859_15Latin-9 encoding
XMLEncodingUTF8UNICODE 8 encoding
XMLEncodingUTF16UNICODE encoding
Remark: in this case, XMLBuildString generates a 2-byte header to specify the byte order.
XMLNoEncoding
(Default value)
No encoding

Java The encoding used by default will be Iso8859_1 (Latin character set).

Retrieving the source of an XML document found in an xmlDocument variable Hide the details

<Result> = XMLBuildString(<XML document> [, <Creation options>])
<Result>: Character string
Formatted XML document. This result can be:
  • handled in memory.
  • WINDEV saved in a file in XML format by fSaveText.
  • ...
<XML document>: xmlDocument variable
xmlDocument variable containing the XML document to format.
Caution: The encoding of the result is defined by the Encoding property of the xmlDocument variable. If no encoding is specified, the XML document will be encoded in UTF-8.
<Creation options>: Optional Integer constant
Combination of following values:
XMLDocumentDefault
(default value)
Generates the XML code with a header and from the root.
XMLFormattingGenerates XML code with formatting (indentation and carriage returns).
Java This constant is not available.
Java This constant is not available.
XMLNoHeaderGenerates the XML code without header.
Remarks

XML functions and threads

If your application uses threads, the XML document is shared between all these threads. For more details on threads, see Managing threads.
Component: wd270xml.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment