MatrixInt.ValuesToStrings Method

Overload List

#	Signature	Description
1	void 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.
2	void 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: void 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.

#	Name	Type
1	dstList	TStrings
2	ListIndex	Int32
3	Row	Int32
4	Col	Int32
5	RowCount	Int32
6	ColCount	Int32
7	Delimiter	String
8	Align	TFixedTextAlign
9	Headers	Boolean
10	ColumnWidth	Int32

Result: stored in self (calling object)

Remarks:

Use text Delimiter for columns and store the resulting strings in aList starting at ListIndex. If aList is not large enough, the method will use the Add method of aList 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 for dstList. Use TStringList or StringList types and then call TMemo.Lines.AddStrings(yourList) for best results.

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

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

#	Name	Type
1	dstList	TStrings
2	Delimiter	String
3	Align	TFixedTextAlign
4	Headers	Boolean
5	ColumnWidth	Int32

Result: stored in self (calling object)

Remarks:

Convert all elements of the calling matrix to strings with text delimiter Delimiter and store them in aList, 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.

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);
    }

See Also: MatrixInt.StringsToValues