Funkcia %XML_Load_XSD_Grammar

Funkcia
Funkcia načíta definíciu XSD dokumentu zo súborového systému.
Deklarácia
INT %XML_Load_XSD_Grammar(
   TEXT in fileName,
   TEXT in features
 )

Parametre
fileName Cesta k XSD dokumentu na disku.
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 možné nájsť na http://xerces.apache.org/xerces2-j/features.html.

Návratová hodnota
Handle na otvorenú XSD gramatiku. Ak sa XSD dokument nepodarí otvoriť alebo je chybný, návratová hodnota bude neplatná.
Popis
Funkcia načíta definíciu XSD dokumentu zo súborového systému. Na jej základe sa vytvorí príslušná XSD gramatika, s ktorou je následne možné pracovať pomocou handle, ktorý je vrátený ako návratová hodnota funkcie.
V prípade, že funkcia vráti neplatný výsledok, o chybe, ktorá nastala, je možné dozvedieť sa zavolaním funkcie %XML_GetLastErrorMessage. Po ukončení práce s gramatikou je potrebné gramatiku explicitne uvoľniť z pamäte zavolaním funkcie %XML_FreeGrammar.
Príklad
 INT _grammar
 
 BOOL _bFree
 _grammar := %XML_Load_XSD_Grammar(_FILE_REF_XSD,"")
 .
 .
 .
 _bFree := %XML_FreeGrammar(_grammar)

Súvisiace stránky:

Funkcie pre prácu s XML súbormi
Argumenty funkcie - typy

Napíšte komentár