System.SetString
Delphi
procedure SetString(var S: String; Buffer: PChar; Length: Integer);
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
procedure | public | System.pas | System | System |
説明
指定した文字列の内容と長さを設定します。
Delphi コードでは、SetString は指定された文字列変数の内容と長さを、パラメータ Buffer
および Length
で指定された文字列のブロックに設定します。
短い文字列変数の場合、SetString は長さの指示文字(S
[0] の文字)を Length
で指定される値に設定し、その後、Buffer
パラメータが nil ではなければ、Length
個分の文字を、Buffer
から文字列へ、S
[1] の位置からコピーします。短い文字列変数の場合、Length
パラメータは 0 から 255 の間の値でなければなりません。
長い文字列変数の場合、SetString は、S
を指定された長さで新たに確保された文字列を参照するように設定します。Buffer
パラメータが nil でなければ、その後、SetString は Length
個分の文字を、Buffer
から文字列にコピーします。そうでなければ、新しい文字列の内容は未初期化のままになります。文字列を作成するのに十分なメモリがなかった場合、EOutOfMemory 例外が発生します。SetString への呼び出しの後、S
は、固有の文字列(参照カウントが 1 である文字列)を参照することが保証されています。