API:System.AnsiStringT.SetLength

提供:RAD Studio API Documentation

C++

AnsiStringT&  SetLength(int newLength) {

プロパティ

種類 可視性 ソース ユニット
function public dstring.h System AnsiStringT

説明

SetLength メソッドは,AnsiStringBase の長さを変更します。 {{#multireplace:System.AnsiStringT.SetLength|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} は {{#multireplace:System.AnsiStringBase.SetLength|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} を継承しています。以下の内容はすべて {{#multireplace:System.AnsiStringBase.SetLength|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} を参照しています。

SetLength メソッドは,AnsiStringBase の長さを変更します。

SetLength メソッドは,文字列の長さを newLength に変更し,必要であれば長さを切り詰めます。

SetLength は,AnsiStringBase の値を格納する基底の文字配列を割り当て直します。文字列の既存の文字は保存されますが,新しく割り当てられた空間の内容は未定義です。AnsiStringBase を再割り当てするのに使用可能なメモリが不足している場合,EOutOfMemory 例外が送出されます。SetLength を呼び出した後,AnsiStringBase は共有参照にはなりません。

SetLength は,修正された AnsiStringBase オブジェクト(*this)を返します。