Stream オブジェクト内のカレントの位置を示します。
設定値と戻り値
ストリームの先頭からカレントの位置までのオフセットを示す長整数型 (Long) の値を、バイト単位で設定します。また、値の取得も可能です。既定値は、ストリームの最初のバイトを表す 0 です。
解説
カレントの位置は、ストリームの末尾を超えて移動できます。ストリームの末尾を超えてカレントの位置を指定すると、Stream オブジェクトの Size もそれに応じて増えます。こうして追加される新しいバイトは Null になります。
注意 Position の単位は常にバイトです。マルチバイト文字セットを使うテキスト ストリームでは、すべての文字が同じバイト数である文字セットを使う場合、Position は文字数 -1 に 1 文字のバイト数を乗じた値です。たとえば、2 バイト文字セットの場合、最初の文字は、位置 0、2 番目の文字は、位置 2、3 番目の文字は、位置 4 のように続きます。
Stream のカレントの位置は負の数では変更できません。Position には正の数しか使えません。
読み取り専用 Stream オブジェクトの場合、Position を Stream の Size より大きく設定するとエラーになります。これで Stream のサイズや Stream の内容が変化することはありません。ただし、Position の値が意味のない値になるので、このような操作はしないでください。