The SDL Component Suite is an industry leading collection of components supporting scientific and engineering computing. Please visit the SDL Web site for more information....


Class:TMatrix, TIntMatrix, TMat3D
Declaration:function ReadFromOpenXMLFile (var InFile: TextFile; DataID: string): boolean;

The function ReadFromOpenXMLFile reads a matrix from the current position of the file InFile. If the parameter DataID is empty, the first <matrix> tag is evaluated and read into the matrix. If DataID is not empty, the entire rest of the open file InFile is read until a <matrix> tag is found whose attribute "id " matches DataID (the recognition of the "id " attribute is not case-sensitive). The property DataID is set to the identification string of the XML data source. The function ReadFromOpenXMLFile returns TRUE if both a valid starting tag <matrix> and a valid end tag </matrix> has been found and the matrix has been updated. In this case the OnChange event is triggered.

Hint 1: For a description of the valid tags, please see WriteToOpenXMLFile.

Hint 2: The XML description of the matrix data has to follow a certain order: number of columns and rows have to precede all other data.

Hint 3: ReadFromOpenXMLFile is by a factor of 5 faster than ReadFromXMLStream. Thus you should use ReadFromOpenXMLFile when reading large matrices with more than approx. 10000 cells.

Last Update: 2012-Okt-20