TMtx.ValuesToStrings Method

Overload List

#	Signature	Description
1	Int32 ValuesToStrings(TStrings dstList, Int32 ListIndex, Int32 Row, Int32 Col, Int32 RowCount, Int32 ColCount, String Delimiter, TFixedTextAlign Align, String ReFormat, String ImFormat, Boolean Headers, Int32 ColumnWidth)	Convert calling matrix elements, starting with [Row,Col] until [row + RowCount, col + ColCount] converting Len elements to strings.
2	Int32 ValuesToStrings(TStrings dstList, String Delimiter, TFixedTextAlign Align, String ReFormat, String ImFormat, 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, String ReFormat, String ImFormat, Boolean Headers, Int32 ColumnWidth)

Convert calling matrix elements, starting with [Row,Col] until [row + RowCount, col + ColCount] converting Len 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	ReFormat	String
10	ImFormat	String
11	Headers	Boolean
12	ColumnWidth	Int32

Returns: Int32

Remarks:

Formatting real parts with ReFormat, imaginary parts with ImFormat, using the text delimiter Delimiter and store them in dstList starting at ListIndex. If dstList is not large enough, the method will use the Add method of dstList object.

Returns column width, when alignment is other than none.

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: Int32 ValuesToStrings(TStrings dstList, String Delimiter, TFixedTextAlign Align, String ReFormat, String ImFormat, 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	ReFormat	String
5	ImFormat	String
6	Headers	Boolean
7	ColumnWidth	Int32

Returns: Int32

Remarks:

Convert all elements of the calling matrix to strings with formating real parts with ReFormat, imaginary parts with ImFormat, using the text delimiter Delimiter and store them in dstList, by using the Add method of TStrings object.

Examples

procedure TForm1.Button1Click(Sender: TObject);
TMtx a;
TMtx b;
MtxVec.CreateIt(out a, out b);
try
    {
        a.SetIt(2,2,false,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: TMtx.StringsToValues