Skip to content

TStrings.CommaText

Contents of the list as a comma-separated string.

Declaration

Source position: classesh.inc line 769

public Property
  CommaText : string;

Description

CommaText represents the stringlist as a single string, consisting of a comma-separated concatenation of the strings in the list. If one of the strings contains spaces, comma's or quotes it will be enclosed by double quotes. Any double quotes in a string will be doubled. For instance the following strings:

Comma,string
Quote"string
Space string
NormalSttring

is converted to

"Comma,string","Quote""String","Space string",NormalString

Conversely, when setting the CommaText property, the text will be parsed according to the rules outlined above, and the strings will be set accordingly. Note that spaces will in this context be regarded as string separators, unless the string as a whole is contained in double quotes. Spaces that occur next to a delimiter will be ignored. The following string:

"Comma,string" , "Quote""String",Space string,, NormalString

Will be converted to

Comma,String
Quote"String
Space
String
NormalString

This is a special case of the TStrings.DelimitedText property where the quote character is always the double quote, and the delimiter is always the colon.

See also

Name Description
TStrings.SetText Set the contents of the list from a PChar.
TStrings.Text Contents of the list as one big string.