TVec.ValuesToStrings Method

Overload List

#	Signature	Description
1	Int32 ValuesToStrings(TStrings dstList, TFixedTextAlign Align, String ReFormat, String ImFormat, Boolean Headers, Int32 ColumnWidth)	Converts the content of the Values array of the calling vector to a list of strings.
2	Int32 ValuesToStrings(TStrings dstList, Int32 ListIndex, Int32 Index, Int32 Len, TFixedTextAlign Align, String ReFormat, String ImFormat, Boolean Headers, Int32 ColumnWidth)	Convert elements from Index to Index+Len-1 of the calling vector to strings.

Overload 1: Int32 ValuesToStrings(TStrings dstList, TFixedTextAlign Align, String ReFormat, String ImFormat, Boolean Headers, Int32 ColumnWidth)

Converts the content of the Values array of the calling vector to a list of strings.

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

Returns: Int32

Remarks:

Converts all elements of the calling vector to strings with formating ReFormat for the real part and ImFormat for the imaginary part and stores them in dstList, by using the Add method of TStringsobject. If vector is not complex only the ReFormat is used.

Note
Complex numbers are formated by default as: a+bi. You can have any formating by specifying the ReFormat and ImFormat parameters, but in order for the Dew.Math.TVec.StringsToValues to work, the basic a+bi formating must be preserved - (chars '+' (' - ') and charI ).

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.

Examples

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

Overload 2: Int32 ValuesToStrings(TStrings dstList, Int32 ListIndex, Int32 Index, Int32 Len, TFixedTextAlign Align, String ReFormat, String ImFormat, Boolean Headers, Int32 ColumnWidth)

Convert elements from Index to Index+Len-1 of the calling vector to strings.

#	Name	Type	Description
1	dstList	TStrings
2	ListIndex	Int32
3	Index	Int32	start index
4	Len	Int32	element count
5	Align	TFixedTextAlign
6	ReFormat	String
7	ImFormat	String
8	Headers	Boolean
9	ColumnWidth	Int32

Returns: Int32

Remarks:

Use ReFormat for the real part and ImFormat for the imaginary part and store them in dstList starting at ListIndex. If dstList is not large enough, the method will use the add method of dstList object. If vector is not complex, only the ReFormat is used.