Unit 'Classes' Package
[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index] [#rtl]

TStrings.CommaText

Contents of the list as a comma-separated string.

Declaration

Source position: classesh.inc line 1063

public property TStrings.CommaText : string
  read GetCommaText
  write SetCommaText;

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
NormalString

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. If the TStrings.StrictDelimiter property is false, then whitespace characters near delimiters will be ignored. The following string:

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

Will be converted to

Comma,string
Quote"string
Space
string

NormalString
Comma,string
_
_"Quote""string"
Space_string

_NormalString

The CommaText is a special case of the TStrings.DelimitedText property where the quote character is always the double quote (TStrings.QuoteChar is ignored), and the delimiter is always a comma.

Setting CommaText is equivalent to clearing the stringlist and calling TStrings.AddCommaText.

See also

TStrings.StrictDelimiter

  

Should only the delimiter character be considered a delimiter.

TStrings.Text

  

Contents of the list as one big string.

TStrings.SetText

  

Set the contents of the list from a PChar.

TStrings.DelimitedText

  

Get or set all strings in the list in a delimited form.

TStrings.AddCommaText

  

Adds a comma-separated list of strings.


Documentation generated on: Apr 14 2026