Topics   All   MacOS (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Deprecated   Guides   Examples   Videos
New in version: 12.1   12.2   12.3   12.4   12.5   13.0   13.1   13.2   13.3   13.4    Statistic    FMM    Blog  

XML.ReadFile

Reads a file as XML.

Component Version macOS Windows Linux Server iOS SDK
XML 7.4 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "XML.ReadFile"; Path { ; Flags } )   More

Parameters

Parameter Description Example Flags
Path The file path or URL to read as XML file. "/Users/cs/Desktop/test.xml"
Flags 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 Optional

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

Release notes

Blog Entries

This function checks for a license.

Created 17th September 2017, last changed 17th September 2017


XML.ReadContainer - XML.Release

💬 Ask a question or report a problem