System.WideStrings.TWideStrings.CommaText
Delphi
property CommaText: WideString read GetCommaText write SetCommaText;
C++
__property System::WideString CommaText = {read=GetCommaText, write=SetCommaText};
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
| property | public | System.WideStrings.pas System.WideStrings.hpp |
System.WideStrings | TWideStrings |
説明
TWideStrings オブジェクトの文字列をシステム データ形式（SDF）でリストします。
TWideStrings オブジェクト内のすべての文字列を、1 つのコンマで区切って取得したり設定するには、CommaText を使用します。
CommaText を取得した場合は、スペース、コンマ、または引用符を含む任意の文字列は、二重引用符で囲まれています。また、文字列内の二重引用符は 2 回繰り返されます。たとえば、リストに次の文字列が含まれていた場合を考えます。
Stri,ng 1 Stri"ng 2 String 3 String4
CommaText は次の文字列を返します。
"Stri,ng 1","Stri""ng 2","String 3",String4
CommaText に代入した場合、その値は SDF 形式のテキストとして解析されます。 SDF 形式では、文字列は、コンマまたはスペースで区切られています。また、オプションで二重引用符で囲んでもかまいません。文字列の一部となっている二重引用符は、文字列を囲むための引用符と区別するために、2 回繰り返されます。二重引用符に囲まれていないスペースやコンマは、区切り文字になります。2 つのコンマが隣り合っている場合は、空の文字列を表します。ただし、別の区切り文字の隣にあるスペースは無視されます。たとえば、CommaText に次の文字列を設定した場合を考えます。
"Stri,ng 1", "Stri""ng 2" , String 3,String4
リストには次の文字列が含まれることになります。
Stri,ng 1 Stri"ng 2 String 3 String4
メモ： CommaText は、区切り文字が ',' で引用符文字が '"' の場合の DelimitedText と同じです。
ソース文字列の末尾にコンマが含まれる場合は、文字列リストに空白の項目が含まれる結果になります。たとえば、CommaText に次の文字列を設定した場合を考えます。
"String1, String 2, String 3,"
文字列リストには次の文字列が含まれることになります。
String1 String2 String3 <Blank>