Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server (Not)   Client   Old   Guides   Examples
New in version: 6.2   6.3   6.4   6.5   7.0   7.1   7.2   7.3   7.4   7.5    Statistic  

XML.ReadFile

Reads a file as XML.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
XML 7.4 Yes Yes Yes Yes Yes

MBS( "XML.ReadFile"; Path { ; Flags } )

Parameters

Parameter Description Example value
Path The file path or URL to read as XML file. "/Users/cs/Desktop/test.xml"
Flags Optional
Various Flags.
Add 1 to ignore errors in xml and continue parsing. This may lead to not everything in the xml being read.
Add 8 to remove all namespaces before query to have queries easier.
0

Result

Returns XML reference or error.

Description

Reads a file as XML.
The document stays in memory and can be queried several times as needed.
If you need to query a lot of values, please parse once first. Else all XML functions need to parse again on each call.
Not limited in file size, so you can read in giga byte big files if you have free memory.
Please use XML.Release later to free document from memory.

By passing XML directly from file content to XML engine, we avoid any corruption due to wrong encoding or line endings.

This function requires a native path. Use Path.FileMakerPathToNativePath to convert a FileMaker path to a native path if required. If you like to have the user choose the path, you can use FileDialog functions.
For Server be aware that server has limited permissions and may not be able to access all files on a computer.

Examples

Read XML file:

$xmlRef = MBS( "XML.ReadFile"; "/Users/cs/Desktop/iTunes Library.xml")

See also


XML.ReadContainer   -   XML.Release

Feedback: Report problem or ask question.




Links
MBS Xojo Plugins