Открывает файл и считывает в память все содержание, формирующее структуру DOM. |
Краткое описание
int xmlDocumentFromFile(string fileName, string &errMsg, int &errLine, int &errColumn); |
Параметры
Параметр | Значение |
fileName | Абсолютный путь к открываемому файлу. |
errMsg | Сообщение, предупреждающее об ошибке. |
errLine | Строка документа, в которой произошла ошибка. |
errColumn | Столбец документа, в котором произошла ошибка. |
Возвращаемое значение
Возвращает идентификатор документа, передаваемый, в будущем, для других вызовов XML. В случае возникновения ошибок функция возвращает -1. |
Описание
Открывает файл и считывает в память все содержание, формирующее структуру DOM. Возвращает идентификатор документа, передаваемый, в будущем, для других вызовов XML. Возвращаемый идентификатор действителен до вызова xmlCloseDocument(). В случае ошибки, errMsg, errLine, errColumn содержат ссылку на позицию, в которой произошла ошибка синтаксического анализа. |
ПРИМЕР
#uses «CtrlXml» main() { int Id; string fileName = «c:/XmlTest.xml»; string errMsg; int errLine, errColumn; Id = xmlDocumentFromFile(fileName, errMsg, errLine, errColumn); DebugN(«The ID:», Id); DebugN(«Errors:», errMsg, errLine, errColumn); } |
Используется для объекта
Доступность
CTRL. В каждом сценарии, в котором используется расширение «CtrlXml» (#uses «CtrlXml»). |
См. также