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.
Pridať komentár