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"<specific pattern. On platforms that do not support the ;TI"C<em>posix_fadvise(2)</em> 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".<em>man 2 posix_fadvise</em> 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"5pipe. (Linux raises Errno::EINVAL in this case).;To;;[I"TypeError;T;	[o;
;	[I"5Either _advice_ was not a Symbol, or one of the ;TI"(other 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