TMtxSmallInt.ValuesToStrings Method

TMtxSmallInt Class

Overload List

#SignatureDescription
1Int32 ValuesToStrings(TStrings dstList, Int32 ListIndex, Int32 Row, Int32 Col, Int32 RowCount, Int32 ColCount, String Delimiter, TFixedTextAlign Align, Boolean Headers, Int32 ColumnWidth)Convert calling matrix elements, starting with [Row,Col] and up to [Row+RowCount-1,Col+ColCount-1] elements to strings.
2Int32 ValuesToStrings(TStrings dstList, String Delimiter, TFixedTextAlign Align)Converts the content of the matrix Values array to a list of strings.
3Int32 ValuesToStrings(TStrings dstList, String Delimiter, TFixedTextAlign Align, Boolean Headers, Int32 ColumnWidth)Converts the content of the matrix Values array to a list of strings.

Overload 1: Int32 ValuesToStrings(TStrings dstList, Int32 ListIndex, Int32 Row, Int32 Col, Int32 RowCount, Int32 ColCount, String Delimiter, TFixedTextAlign Align, Boolean Headers, Int32 ColumnWidth)

Convert calling matrix elements, starting with [Row,Col] and up to [Row+RowCount-1,Col+ColCount-1] elements to strings.

#NameTypeDescription
1dstListTStrings
2ListIndexInt32
3RowInt32
4ColInt32
5RowCountInt32
6ColCountInt32
7DelimiterString
8AlignTFixedTextAlign
9HeadersBoolean
10ColumnWidthInt32

Returns: Int32

Remarks:

Use text Delimiter for columns and store the resulting strings in dstList starting at ListIndex. If dstList is not large enough, the method will use the Add method of dstList object. Existing items will be overwritten. Set Align to have columns aligned left or right when using fixed width font (like Courier New). Specifiy Headers to be "true", if row and column labels are to be printed.

Performance note:
This routine will be exceedingly slow, if TRichEdit.Lines or TMemo.Lines are passed as a parameter. Use TStringList or StringList types and then call Memo.Lines.AddStrings(yourList) for best results.

Overload 2: Int32 ValuesToStrings(TStrings dstList, String Delimiter, TFixedTextAlign Align)

Converts the content of the matrix Values array to a list of strings.

#NameTypeDescription
1dstListTStrings
2DelimiterString
3AlignTFixedTextAlign

Returns: Int32

Remarks:

Performance note:
This routine will be exceedingly slow, if TRichEdit.Lines or TMemo.Lines are passed as a parameter. Use TStringList or StringList types and then call Memo.Lines.AddStrings(yourList) for best results.

Overload 3: Int32 ValuesToStrings(TStrings dstList, String Delimiter, TFixedTextAlign Align, Boolean Headers, Int32 ColumnWidth)

Converts the content of the matrix Values array to a list of strings.

#NameTypeDescription
1dstListTStrings
2DelimiterString
3AlignTFixedTextAlign
4HeadersBoolean
5ColumnWidthInt32

Returns: Int32

Remarks:

Convert all elements of the calling matrix to strings with text delimiter Delimiter and store them in dstList, by using the Add method of TStrings object. Set Align to have columns aligned left or right when using fixed width font (like Courier New). Specifiy Headers to be "true", if row and column labels are to be printed.

Performance note:
This routine will be exceedingly slow, if TRichEdit.Lines or TMemo.Lines are passed as a parameter. Use TStringList or StringList types and then call Memo.Lines.AddStrings(yourList) for best results.

Examples
procedure TForm1.Button1Click(Sender: TObject);
TMtxInt a;
TMtxInt b;
MtxVec.CreateIt(out a, out b);
try
    {
        a.SetIt(2,2,new double[] {1,2,3,4});
        a.Cos;
        b.Size(a);
        b.SetVal(1);
        a.Add(b);
        Richedit1.Clear;
        Memo1.Clear;
        a.ValuesToStrings(Richedit1.Lines);
        b.ValuesToStrings(Richedit1.Lines);
        a.ValuesToStrings(Memo1.Lines);
        b.ValuesToStrings(Memo1.Lines);
        Memo1.Lines.SaveToFile(@"C:\Test.txt");
        Memo1.Lines.LoadFromFile(@"C:\Test.txt");
        a.StringsToValues(Memo1.Lines);
    }
finally
    {
        MtxVec.FreeIt(ref a, ref b);
    }