bool axl_doc_dump_pretty_to_file ( axlDoc doc,
char *  file_path,
int  tabular 
)

Allows to dump a xml document directly to the file located at the file path, doing pretty printing operations.

This function saves you the round trip to declare variables to hold the memory, open a file, dump the content and properly close the output file. The function works the same as axl_doc_dump but doing the extra job to transfer the xml document into a file.

See also axl_doc_dump_to_file to get a version dumps the content without doing pretty printing operations.

Parameters:
doc The document to be dumped into a file.
file_path The file path where the output will be placed. The function will require to have access rights to the file (or to create a new file if it doesnt exists). The default behaviour is to overwrite the file found if exists. So, if you don't want to get content overwrited, you must provide the enough code to avoid such situations prior calling to this function.
tabular The amount of white spaces to introduce as tabular for each level found inside the xml.
Returns:
true if the dump operation was ok, otherwisde false is returned.