Parsing the file
Prev |  | Next

## Parsing the file

Parsing the file requires only the name of the file and a single function call, plus error checking. Full code: Appendix C, Code for Keyword Example

             xmlDocPtr doc;
    	 xmlNodePtr cur;

    	 doc = xmlParseFile(docname);

    	 if (doc == NULL ) {
    		fprintf(stderr,"Document not parsed successfully. \n");
    		return;
    	}

    	 cur = xmlDocGetRootElement(doc);

    	 if (cur == NULL) {
    		fprintf(stderr,"empty document\n");
    		xmlFreeDoc(doc);
    		return;
    	}

    	 if (xmlStrcmp(cur->name, (const xmlChar *) "story")) {
    		fprintf(stderr,"document of the wrong type, root node != story");
    		xmlFreeDoc(doc);
    		return;
    	}

| Declare the pointer that will point to your parsed document.
| Declare a node pointer (you'll need this in order to interact with individual nodes).

Check to see that the document was successfully parsed. If it was not, libxml will at this point register an error and stop.

| Note
One common example of an error at this point is improper handling of encoding. The XML standard requires documents stored with an encoding other than UTF-8 or UTF-16 to contain an explicit declaration of their encoding. If the declaration is there, libxml will automatically perform the necessary conversion to UTF-8 for you. More information on XML's encoding requirements is contained in the standard.

| Retrieve the document's root element.
| Check to make sure the document actually contains something.
| In our case, we need to make sure the document is the right type. "story" is the root type of the documents used in this tutorial.

Prev | Up | Next
Data Types | Home | Retrieving Element Content