ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Standard functions / XML file functions
  • 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.
WINDEVWEBDEV - Server codeWINDEV Mobile 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.
WEBDEV - Browser code The corresponding character string can be sent to the server for example.
AndroidAndroid Widget Java In the final XML document, the list of attributes is sorted in alphabetical order.
AndroidAndroid Widget 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.
WINDEVWEBDEV - Server codeReports and QueriesAndroidAndroid Widget JavaUser code (UMC)PHPAjax
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)
WEBDEV - Browser code
XMLSource is string
Res is boolean
 
// Create the XML document
Res = XMLDocument("XMLDoc", XMLSource)
 
// Modify the XML document
...
 
// Retrieve and format the XML document
XMLSource = XMLBuildString("XMLDoc")
 
// Send the XML document to the server
AJAXExécute(MyProc, 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.
  • WINDEVWEBDEV - Server codeWINDEV Mobile saved in a file in XML format by fSaveText.
  • WEBDEV - Browser code sent to the server.
  • ...
<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

WEBDEV - Browser codePHP This parameter is not available. The encoding used is Iso8859_1.
AndroidAndroid Widget 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.
  • WINDEVWEBDEV - Server codeWINDEV Mobile saved in a file in XML format by fSaveText.
  • WEBDEV - Browser code sent to the server.
  • ...
<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).
AndroidAndroid Widget This constant is now 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: wd290xml.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/08/2022

Send a report | Local help