るりまサーチ

最速Rubyリファレンスマニュアル検索!
100件ヒット [1-100件を表示] (0.031秒)
トップページ > クエリ:ruby[x] > クエリ:offset[x] > クラス:IO[x]

別のキーワード

  1. rbconfig ruby
  2. fiddle ruby_free
  3. fiddle build_ruby_platform
  4. rake ruby
  5. rubygems/defaults ruby_engine

ライブラリ

キーワード

検索結果

IO#advise(advice, offset=0, len=0) -> nil (138.0)

posix_fadvise(2) を呼びだし、 ファイルへのアクセスパターンをOSに知らせます。

...ォーム依存です。

ここでいう「データ」は offset と len で特定することができます。
len が 0 ならば、offset からファイル末尾までを指定したことになります。
デフォルトでは offset と len がともに 0 なので、
ファイル全体を...
...もしません。

@param advice アクセスパターンを表すシンボル
@param offset パターンを指定するデータの先頭位置
@param len パターンを指定するデータの長さ

@raise IOError ストリームが既に閉じられているときに発生する例外
@raise E...
...pipe を指している
場合に発生する例外(Linux はこの場合には Errno::EINVAL を発生する)
@raise RangeError offset,lenが有効範囲から出ている場合に発生する例外

//emlist[例][ruby]{
File.open("testfile") { |f| p f.advise(:sequential) } # => nil
//}...

IO#pwrite(string, offset) -> Integer (130.0)

stringをoffsetの位置にpwrite()システムコールを使って書き込みます。

...stringをoffsetの位置にpwrite()システムコールを使って書き込みます。

IO
#seekとIO#writeの組み合わせと比べて、アトミックな操作に
なるという点が優れていて、複数スレッド/プロセスから同じIOオブジェクトを
様々な位置から読...
...み込むことを許します。
どのユーザー空間のIO層のバッファリングもバイパスします。

@param string 書き込む文字列を指定します。
@param offset ファイルポインタを変えずに書き込む位置を指定します。

@return 書き込んだバイ...
...敗した場合に発生します。
@raise NotImplementedError システムコールがサポートされていない OS で発生します。

//emlist[例][ruby]{
File.open("testfile", "w") do |f|
f.pwrite("ABCDEF", 3) # => 6
end

File.read("testfile") # => "\u0000\u0000\u0000ABCDEF"
//}...

IO.binwrite(path, string, offset=nil) -> Integer (126.0)

path で指定されるファイルを開き、string を書き込み、 閉じます。

...ある点以外は IO.write と同じです。

Kernel.#open と同様 path の先頭が "|" ならば、"|" に続くコマンドを実行し、コマンドの出力を標準出力に書き込みます。

offset
を指定するとその位置までシークします。

offset
を指定しない...
...尾でファイルを
切り捨てます。

@param path ファイル名文字列
@param string 書き込む文字列
@param offset 書き込み開始位置

//emlist[例][ruby]{
# 8x8の真っ白なPNG画像データ。
png = 'iVBORw0KGgoAAAANSUhEUgAAAAgAAAAICAAAAADhZOFXAAAADklEQVQIW2P4DwUMlDEA98A/...
...89 50 4e 47 0d 0a 1a 0a 00 00 00 0d 49 48 44 52

# binwriteを使用した場合: どの環境でも正しく保存できる。
IO
.binwrite('white.binmode.png', png)
puts IO.binread('white.binmode.png', 16).unpack('C*').map {|c| '%02x' % c }.join(' ')
# => 89 50 4e 47 0d 0a 1a 0a 00 00 00 0d 49 48 4...

IO.write(path, string, offset=nil, **opts) -> Integer (126.0)

path で指定されるファイルを開き、string を書き込み、 閉じます。

...ならば、"|" に続くコマンドを実行し、コマンドの出力を標準出力に書き込みます。

offset
を指定するとその位置までシークします。

offset
を指定しないと、書き込みの末尾でファイルを
切り捨てます。

キーワード引数は...
...とができます。
詳しくは IO.open を見てください。

@param path ファイル名文字列
@param string 書き込む文字列
@param offset 書き込み開始位置
@param opts ファイルを開くときのキーワード引数

//emlist[例][ruby]{
text = "This is line one\nThis is...
...s line three\nAnd so on...\n"
IO
.write("testfile", text) # => 66
IO
.write("testfile", "0123456789", 20) #=> 10
IO
.read("testfile")
# => "This is line one\nThi0123456789two\nThis is line three\nAnd so on...\n"
IO
.write("testfile", "0123456789") #=> 10
IO
.read("testfile")...

IO.binread(path, length = nil, offset = 0) -> String | nil (124.0)

path で指定したファイルを open し、offset の所まで seek し、 length バイト読み込みます。

...path で指定したファイルを open し、offset の所まで seek し、
length バイト読み込みます。

Kernel.#open と同様 path の先頭が "|" ならば、"|" に続くコマンドの出力を読み取ります。

length を省略するとファイルの末尾まで読み込み...
...emlist[例][ruby]{
IO
.write("testfile", "This is line one\nThis is line two\nThis is line three\nAnd so on...\n")
IO
.binread("testfile") # => "This is line one\nThis is line two\nThis is line three\nAnd so on...\n"
IO
.binread("testfile", 20) # => "This is line one\nThi"
IO
.binread("t...
...estfile", 20, 10) # => "ne one\nThis is line "
//}

@see IO.read...

絞り込み条件を変える

IO.copy_stream(src, dst, copy_length, src_offset) -> Integer (120.0)

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

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

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

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

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

@param dst コピー先となる IO オブジェク...
...c_offset コピーを始めるオフセットを数値で指定します。

//emlist[例][ruby]{
IO
.write("filetest", "abcdefghij")
IO
.copy_stream("filetest", "filecopy", 2) # => 2
IO
.read("filecopy") # => "ab"
IO
.copy_stream("filetest", "filecopy", 3, 4) # => 3
IO
.r...

IO#pread(maxlen, offset, outbuf = "") -> string (114.0)

preadシステムコールを使ってファイルポインタを変更せずに、また現在のファイルポインタに 依存せずにmaxlenバイト読み込みます。

...みます。

IO
#seekとIO#readの組み合わせと比べて、アトミックな操作に
なるという点が優れていて、複数スレッド/プロセスから同じIOオブジェクトを
様々な位置から読み込むことを許します。
どのユーザー空間のIO層のバッフ...
...ァリングもバイパスします。

@param maxlen 読み込むバイト数を指定します。
@param offset 読み込み開始位置のファイルの先頭からのオフセットを指定します。
@param outbuf データを受け取る String を指定します。

@raise Errno::EXXX シ...
...時に発生します。
@raise NotImplementedError システムコールがサポートされていない OS で発生します。

//emlist[例][ruby]{
File.write("testfile", "This is line one\nThis is line two\n")
File.open("testfile") do |f|
p f.read # => "This is line one\nThis is l...

IO.write(path, string, **opts) -> Integer (26.0)

path で指定されるファイルを開き、string を書き込み、 閉じます。

...ならば、"|" に続くコマンドを実行し、コマンドの出力を標準出力に書き込みます。

offset
を指定するとその位置までシークします。

offset
を指定しないと、書き込みの末尾でファイルを
切り捨てます。

キーワード引数は...
...とができます。
詳しくは IO.open を見てください。

@param path ファイル名文字列
@param string 書き込む文字列
@param offset 書き込み開始位置
@param opts ファイルを開くときのキーワード引数

//emlist[例][ruby]{
text = "This is line one\nThis is...
...s line three\nAnd so on...\n"
IO
.write("testfile", text) # => 66
IO
.write("testfile", "0123456789", 20) #=> 10
IO
.read("testfile")
# => "This is line one\nThi0123456789two\nThis is line three\nAnd so on...\n"
IO
.write("testfile", "0123456789") #=> 10
IO
.read("testfile")...

IO.copy_stream(src, dst, copy_length = nil) -> Integer (20.0)

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

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

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

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

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

@param dst コピー先となる IO オブジェク...
...c_offset コピーを始めるオフセットを数値で指定します。

//emlist[例][ruby]{
IO
.write("filetest", "abcdefghij")
IO
.copy_stream("filetest", "filecopy", 2) # => 2
IO
.read("filecopy") # => "ab"
IO
.copy_stream("filetest", "filecopy", 3, 4) # => 3
IO
.r...