Porovnávané verzie
porovnané s
Kľúč
- Tento riadok sa pridal
- Riadok je odstránený.
- Formátovanie sa zmenilo.
Funkcia %XML_OpenDocument
Funkcia
Funkcia načíta XML dokument z disku.
Deklarácia
Blok kódu | ||||
---|---|---|---|---|
| ||||
INT %XML_OpenDocument( TEXT in fileName, BOOL in validate[, TEXT in features := ""[, BOOL in preserveWhitespace := @TRUE]] ) |
Parametre
fileName | Meno XML súboru na disku. | ||||||||||||||||||||
validate | @TRUE - vykonanie validácie XML dokumentu (v prípade, že XML dokument obsahuje DTD). @FALSE - bez validácie XML dokumentu (v prípade, že XML dokument obsahuje DTD). | ||||||||||||||||||||
features | Nepovinný parameter typu Text, ktorý umožňuje zmeniť preddefinované hodnoty niektorých parametrov štandardného SAX Parsera a tým ovplyvniť jeho chovanie a následne aj obsah načítaného dokumentu v pamäti. Parametre sa zapisujú vo dvojiciach v poradí meno a číselná hodnota. Jednotlivé časti sú oddelené znakom medzera. Ak je hodnota 0, parameter bude vypnutý, inak zapnutý. Zadanie neplatného mena parametra sa nevyhodnotí ako chyba. Úplný zoznam parametrov je napríklad na http://xerces.apache.org/xerces2-j/features.html. Aktuálna verzia podporuje nasledujúce dva parametre: http://xml.org/sax/features/namespaces
alebo http://xml.org/sax/features/namespace-prefixes
| ||||||||||||||||||||
preserveWhitespace | @TRUE - textové uzly, ktoré obsahujú tzv. biele znaky (medzera, tabelátor, ..) ostanú zachované tak, ako sú v XML dokumente. @FALSE - textové uzly, ktoré obsahujú tzv. biele znaky budú pri parsovaní dokumentu ignorované. |
Návratová hodnota
Handle na otvorený XML dokument. Ak sa dokument nepodarí otvoriť, návratová hodnota bude neplatná.
Popis
Funkcia načíta zadaný XML dokument z disku a vráti jeho handle.
Podporované kódovania XML dokumentu sú:
Podporované kódovania XML dokumentu sú:
- UTF-8
- UTF-16
- US-ASCII
- ISO-8859-1
- Latin1
- ISO-8859-2
- Latin2
- ISO-8859-3
- ISO-8859-4
- WINDOWS-1250
Príklad 1
Blok kódu | ||||
---|---|---|---|---|
| ||||
INT _doc _doc := %XML_OpenDocument("c:\data.xml", @TRUE) |
Príklad 2
Otvorenie XML dokumentu s nastavením parametra (http://xml.org/sax/features/namespace-prefixes) SAX Parsera:
Blok kódu | ||||
---|---|---|---|---|
| ||||
TEXT _features _features := "http://xml.org/sax/features/namespace-prefixes 1" _hXML := %XML_OpenDocument (_fileName, @FALSE, _features) |
Poznámka
Ak je nastavený parameter namespace-prefixes, pri čítaní XML dokumentu sa nebudú ignorovať xmlns* atribúty. Nasledovný XML súbor bol čítaný so zapnutým parametrom http://xml.org/sax/features/namespace-prefixes.
![](/download/attachments/84349633/xml_opendocument_features.png?version=1&modificationDate=1507828773585&api=v2)
![](/download/attachments/84349633/xml_opendocument_features.png?version=1&modificationDate=1507828773585&api=v2)