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