System.Classes.TStringList.Add

提供: RAD Studio API Documentation
移動先: 案内検索

Delphi

function Add(const S: string): Integer; override;

C++

virtual int __fastcall Add(const System::UnicodeString S);

プロパティ

種類 可視性 ソース ユニット
function public
System.Classes.pas
System.Classes.hpp
System.Classes TStringList

説明

Add は,新しい文字列をリストに追加します。

Add メソッドを呼び出すと,S パラメータで指定する文字列をリストに追加できます。リストがソートされている場合,S はソート順の適切な位置に追加されます。リストがソートされていない場合,S はリストの末尾に追加されます。Add はリスト内の項目の位置を返します。ただし,リストの先頭項目の値は 0 です。

メモ:  ソートされたリストでは,文字列 S がすでにリストに表示されていて,Duplicates プロパティが dupError に設定されている場合,Add メソッドは EListError 例外を発生させます。Duplicates プロパティが dupIgnore に設定されている場合,重複文字列を追加しようとすると,Add メソッドは既存のエントリのインデックスを返します。

関連項目