U:RDoc::AnyMethod[iI" advise:ETI"IO#advise;TF: publico:RDoc::Markup::Document: @parts[o:RDoc::Markup::Paragraph; [I"EAnnounce an intention to access data from the current file in a ;TI"posix_fadvise(2) system call, this method is a no-op.;To:RDoc::Markup::BlankLineo; ; [I"._advice_ is one of the following symbols:;T@o:RDoc::Markup::List: @type: NOTE: @items[ o:RDoc::Markup::ListItem: @label[I" :normal;T; [o; ; [I"@No advice to give; the default assumption for an open file.;To;;[I":sequential;T; [o; ; [I",The data will be accessed sequentially ;TI"0with lower offsets read before higher ones.;To;;[I" :random;T; [o; ; [I"/The data will be accessed in random order.;To;;[I":willneed;T; [o; ; [I"2The data will be accessed in the near future.;To;;[I":dontneed;T; [o; ; [I"6The data will not be accessed in the near future.;To;;[I" :noreuse;T; [o; ; [I")The data will only be accessed once.;T@o; ; [I"DThe semantics of a piece of advice are platform-dependent. See ;TI".man 2 posix_fadvise for details.;T@o; ; [ I"@"data" means the region of the current file that begins at ;TI"E_offset_ and extends for _len_ bytes. If _len_ is 0, the region ;TI"Fends at the last byte of the file. By default, both _offset_ and ;TI"E_len_ are 0, meaning that the advice applies to the entire file.;T@o; ; [I"HIf an error occurs, one of the following exceptions will be raised:;T@o; ; ;;[ o;;[I"IOError;T; [o; ; [I"*The IO stream is closed.;To;;[I"Errno::EBADF;T; [o; ; [I"8The file descriptor of the current file is invalid.;To;;[I"Errno::EINVAL;T; [o; ; [I"-An invalid value for _advice_ was given.;To;;[I"Errno::ESPIPE;T; [o; ; [I"AThe file descriptor of the current file refers to a FIFO or ;TI"Bpipe. (Linux raises Errno::EINVAL in this case).;To;;[I"TypeError;T; [o; ; [I"5Either _advice_ was not a Symbol, or one of the ;TI"5other arguments was not an Integer.;To;;[I"RangeError;T; [o; ; [I"2One of the arguments given was too big/small.;T@o;;[I"-This list is not exhaustive; other Errno;T; [o; ; [I""exceptions are also possible.;T: @fileI" io.c;T:0@omit_headings_from_table_of_contents_below0I"0ios.advise(advice, offset=0, len=0) -> nil ;T0[I"(p1, p2 = v2, p3 = v3);T@~FI"IO;TcRDoc::NormalClass00