E57Utilities errorCodeToString getVersions rawXmlLength rawXmlRead

void rawXmlRead ( const ustring &  fname, uint8_t *  buf, int64_t  logicalStart, size_t  byteCount  ) Read portion of XML section of an E57 file. Parameters: [in] fname File name of the E57 file. [out] buf Buffer to receive bytes read from the XML section of the E57 file. [in] logicalStart Position to start reading in the XML section. First byte is 0. [in] byteCount Number of bytes to read (length of buf). This function enables the extraction of the XML section of a E57 file without creating an ImageFile object. The interspersed checksums are removed after they have been verified. This function cannot be used to read a corrupted file (with bad checksums). The E57 file header section must be well formed. No validation or checking of any kind is performed on the XML read. It is an error to attempt to read outside the XML section of the file. It is not an error to only read a portion of the XML section in a single call. Precondition: logicalStart+byteCount <= rawXmlLength() Exceptions: E57_ERROR_BAD_API_ARGUMENT E57_ERROR_LSEEK_FAILED E57_ERROR_READ_FAILED E57_ERROR_BAD_CHECKSUM E57_ERROR_BAD_FILE_SIGNATURE E57_ERROR_UNKNOWN_FILE_VERSION E57_ERROR_BAD_FILE_LENGTH E57_ERROR_INTERNAL All objects in undocumented state See also: RawXML.cpp example, E57Utilities::rawXmlLength, E57Utilities::E57Utilities