Ruby 2.3.0 リファレンスマニュアル > ライブラリ一覧 > 組み込みライブラリ > IOクラス > copy_stream

singleton method IO.copy_stream

copy_stream(src, dst, copy_length = nil) -> Integer[permalink][rdoc]

copy_stream(src, dst, copy_length, src_offset) -> Integer

指定された src から dst へコピーします。 コピーしたバイト数を返します。

コピー元の src が IO オブジェクトの場合は、src のオフセットから ファイル名の場合はファイルの最初からコピーを開始します。 コピー先の dst に関しても同様です。

dst にファイル名を指定し、そのファイルが存在しない場合、 ファイルは作成されます。ファイルが存在する場合は長さ 0 に切り詰められます。

src が IO オブジェクトでかつ src_offset が指定されている場合、 src のオフセット(src.pos)は変更されません。

[PARAM] src:

コピー元となる IO オブジェクトかファイル名を指定します。

[PARAM] dst:

コピー先となる IO オブジェクトかファイル名を指定します。

[PARAM] copy_length:

コピーする長さをバイト単位で指定します。最大 copy_length までコピーされます。 nil を指定した場合、コピーする長さに制限はありません。

[PARAM] src_offset:

コピーを始めるオフセットを数値で指定します。

例

IO.write("filetest", "abcdefghij")
IO.copy_stream("filetest", "filecopy", 2)     # => 2
IO.read("filecopy")                           # => "ab"
IO.copy_stream("filetest", "filecopy", 3, 4)  # => 3
IO.read("filecopy")                           # => "efg"