Gecko [ beriskala.com ]

Name	Size	Permission	Date
%60-i.ri	714 B	-rw-r--r--	2023-07-26 17:52
Array-i.ri	512 B	-rw-r--r--	2023-07-26 17:52
BigDecimal-i.ri	343 B	-rw-r--r--	2023-07-26 17:52
Complex-i.ri	1.47 KB	-rw-r--r--	2023-07-26 17:52
Float-i.ri	629 B	-rw-r--r--	2023-07-26 17:52
Hash-i.ri	683 B	-rw-r--r--	2023-07-26 17:52
Integer-i.ri	1.33 KB	-rw-r--r--	2023-07-26 17:52
JSON-i.ri	651 B	-rw-r--r--	2023-07-26 17:52
Pathname-i.ri	748 B	-rw-r--r--	2023-07-26 17:52
Rational-i.ri	1.17 KB	-rw-r--r--	2023-07-26 17:52
String-i.ri	623 B	-rw-r--r--	2023-07-26 17:52
__callee__-i.ri	426 B	-rw-r--r--	2023-07-26 17:52
__dir__-i.ri	612 B	-rw-r--r--	2023-07-26 17:52
__method__-i.ri	444 B	-rw-r--r--	2023-07-26 17:52
abort-i.ri	483 B	-rw-r--r--	2023-07-26 17:52
at_exit-i.ri	833 B	-rw-r--r--	2023-07-26 17:52
autoload%3f-i.ri	515 B	-rw-r--r--	2023-07-26 17:52
autoload-i.ri	617 B	-rw-r--r--	2023-07-26 17:52
binding-i.ri	745 B	-rw-r--r--	2023-07-26 17:52
block_given%3f-i.ri	777 B	-rw-r--r--	2023-07-26 17:52
callcc-i.ri	870 B	-rw-r--r--	2023-07-26 17:52
caller-i.ri	1.51 KB	-rw-r--r--	2023-07-26 17:52
caller_locations-i.ri	1.07 KB	-rw-r--r--	2023-07-26 17:52
catch-i.ri	1.32 KB	-rw-r--r--	2023-07-26 17:52
cdesc-Kernel.ri	3.6 KB	-rw-r--r--	2023-07-26 17:52
chomp-i.ri	473 B	-rw-r--r--	2023-07-26 17:52
chop-i.ri	460 B	-rw-r--r--	2023-07-26 17:52
eval-i.ri	953 B	-rw-r--r--	2023-07-26 17:52
exec-i.ri	3.54 KB	-rw-r--r--	2023-07-26 17:52
exit%21-i.ri	536 B	-rw-r--r--	2023-07-26 17:52
exit-i.ri	1.47 KB	-rw-r--r--	2023-07-26 17:52
fail-i.ri	1.1 KB	-rw-r--r--	2023-07-26 17:52
fork-i.ri	1.41 KB	-rw-r--r--	2023-07-26 17:52
format-i.ri	12.83 KB	-rw-r--r--	2023-07-26 17:52
gem-i.ri	1.56 KB	-rw-r--r--	2023-07-26 17:52
gem_original_require-i.ri	392 B	-rw-r--r--	2023-07-26 17:52
gets-i.ri	1.55 KB	-rw-r--r--	2023-07-26 17:52
global_variables-i.ri	500 B	-rw-r--r--	2023-07-26 17:52
gsub-i.ri	514 B	-rw-r--r--	2023-07-26 17:52
iterator%3f-i.ri	771 B	-rw-r--r--	2023-07-26 17:52
j-i.ri	365 B	-rw-r--r--	2023-07-26 17:52
jj-i.ri	382 B	-rw-r--r--	2023-07-26 17:52
lambda-i.ri	426 B	-rw-r--r--	2023-07-26 17:52
load-i.ri	811 B	-rw-r--r--	2023-07-26 17:52
local_variables-i.ri	534 B	-rw-r--r--	2023-07-26 17:52
loop-i.ri	674 B	-rw-r--r--	2023-07-26 17:52
open-c.ri	3.6 KB	-rw-r--r--	2023-07-26 17:52
open-i.ri	3.6 KB	-rw-r--r--	2023-07-26 17:52
open_uri_original_open-c.ri	283 B	-rw-r--r--	2023-07-26 17:52
open_uri_original_open-i.ri	282 B	-rw-r--r--	2023-07-26 17:52
p-i.ri	679 B	-rw-r--r--	2023-07-26 17:52
pretty_inspect-i.ri	544 B	-rw-r--r--	2023-07-26 17:52
print-i.ri	986 B	-rw-r--r--	2023-07-26 17:52
printf-i.ri	523 B	-rw-r--r--	2023-07-26 17:52
proc-i.ri	330 B	-rw-r--r--	2023-07-26 17:52
putc-i.ri	480 B	-rw-r--r--	2023-07-26 17:52
puts-i.ri	397 B	-rw-r--r--	2023-07-26 17:52
raise-i.ri	1.11 KB	-rw-r--r--	2023-07-26 17:52
rand-i.ri	1.3 KB	-rw-r--r--	2023-07-26 17:52
readline-i.ri	463 B	-rw-r--r--	2023-07-26 17:52
readlines-i.ri	487 B	-rw-r--r--	2023-07-26 17:52
require-i.ri	1.08 KB	-rw-r--r--	2023-07-26 17:52
require_relative-i.ri	550 B	-rw-r--r--	2023-07-26 17:52
scanf-i.ri	501 B	-rw-r--r--	2023-07-26 17:52
select-i.ri	6.48 KB	-rw-r--r--	2023-07-26 17:52
set_trace_func-i.ri	2.4 KB	-rw-r--r--	2023-07-26 17:52
sleep-i.ri	911 B	-rw-r--r--	2023-07-26 17:52
spawn-i.ri	12.4 KB	-rw-r--r--	2023-07-26 17:52
sprintf-i.ri	12.83 KB	-rw-r--r--	2023-07-26 17:52
srand-i.ri	1.33 KB	-rw-r--r--	2023-07-26 17:52
sub-i.ri	517 B	-rw-r--r--	2023-07-26 17:52
syscall-i.ri	1.54 KB	-rw-r--r--	2023-07-26 17:52
system-i.ri	1.42 KB	-rw-r--r--	2023-07-26 17:52
test-i.ri	3 KB	-rw-r--r--	2023-07-26 17:52
throw-i.ri	630 B	-rw-r--r--	2023-07-26 17:52
trace_var-i.ri	1.02 KB	-rw-r--r--	2023-07-26 17:52
trap-i.ri	1.55 KB	-rw-r--r--	2023-07-26 17:52
untrace_var-i.ri	571 B	-rw-r--r--	2023-07-26 17:52
warn-i.ri	647 B	-rw-r--r--	2023-07-26 17:52
y-i.ri	332 B	-rw-r--r--	2023-07-26 17:52

Rename

U:RDoc::AnyMethod[iI"select:ETI"Kernel#select;TF:publico:RDoc::Markup::Document:@parts[-o:RDoc::Markup::Paragraph;	[I""Calls select(2) system call. ;TI"LIt monitors given arrays of <code>IO</code> objects, waits one or more ;TI"Jof <code>IO</code> objects ready for reading, are ready for writing, ;TI"Iand have pending exceptions respectively, and returns an array that ;TI"Kcontains arrays of those IO objects. It will return <code>nil</code> ;TI"Mif optional timeout value is given and no <code>IO</code> object ;TI"(is ready in timeout seconds.;To:RDoc::Markup::BlankLine�o;
;	[
I"a<code>IO.select</code> peeks the buffer of <code>IO</code> objects for testing readability. ;TI"1If the <code>IO</code> buffer is not empty, ;TI"<<code>IO.select</code> immediately notify readability. ;TI"=This "peek" is only happen for <code>IO</code> objects. ;TI"JIt is not happen for IO-like objects such as OpenSSL::SSL::SSLSocket.;T@o;
;	[I"?The best way to use <code>IO.select</code> is invoking it ;TI"eafter nonblocking methods such as <code>read_nonblock</code>, <code>write_nonblock</code>, etc. ;TI":The methods raises an exception which is extended by ;TI"E<code>IO::WaitReadable</code> or <code>IO::WaitWritable</code>. ;TI"PThe modules notify how the caller should wait with <code>IO.select</code>. ;TI"UIf <code>IO::WaitReadable</code> is raised, the caller should wait for reading. ;TI"TIf <code>IO::WaitWritable</code> is raised, the caller should wait for writing.;T@o;
;	[I"HSo, blocking read (<code>readpartial</code>) can be emulated using ;TI"F<code>read_nonblock</code> and <code>IO.select</code> as follows:;T@o:RDoc::Markup::Verbatim;	[I"begin
;TI". result = io_like.read_nonblock(maxlen)
;TI"rescue IO::WaitReadable
;TI" IO.select([io_like])
;TI"
 retry
;TI"rescue IO::WaitWritable
;TI"! IO.select(nil, [io_like])
;TI"
 retry
;TI"	end
;T:@format0o;
;	[
I"<Especially, the combination of nonblocking methods and ;TI"B<code>IO.select</code> is preferred for <code>IO</code> like ;TI";objects such as <code>OpenSSL::SSL::SSLSocket</code>. ;TI"SIt has <code>to_io</code> method to return underlying <code>IO</code> object. ;TI"[<code>IO.select</code> calls <code>to_io</code> to obtain the file descriptor to wait.;T@o;
;	[I"QThis means that readability notified by <code>IO.select</code> doesn't mean ;TI"Breadability from <code>OpenSSL::SSL::SSLSocket</code> object.;T@o;
;	[I"XMost possible situation is <code>OpenSSL::SSL::SSLSocket</code> buffers some data. ;TI"4<code>IO.select</code> doesn't see the buffer. ;TI"mSo <code>IO.select</code> can block when <code>OpenSSL::SSL::SSLSocket#readpartial</code> doesn't block.;T@o;
;	[I"7However several more complicated situation exists.;T@o;
;	[I"5SSL is a protocol which is sequence of records. ;TI")The record consists multiple bytes. ;TI"8So, the remote side of SSL sends a partial record, ;TI"5<code>IO.select</code> notifies readability but ;TI"D<code>OpenSSL::SSL::SSLSocket</code> cannot decrypt a byte and ;TI"B<code>OpenSSL::SSL::SSLSocket#readpartial</code> will blocks.;T@o;
;	[I"FAlso, the remote side can request SSL renegotiation which forces ;TI",the local SSL engine writes some data. ;TI"EThis means <code>OpenSSL::SSL::SSLSocket#readpartial</code> may ;TI"=invoke <code>write</code> system call and it can block. ;TI"KIn such situation, <code>OpenSSL::SSL::SSLSocket#read_nonblock</code> ;TI"2raises IO::WaitWritable instead of blocking. ;TI"KSo, the caller should wait for ready for writability as above example.;T@o;
;	[I"JThe combination of nonblocking methods and <code>IO.select</code> is ;TI"Balso useful for streams such as tty, pipe socket socket when ;TI")multiple process read form a stream.;T@o;
;	[	I"=Finally, Linux kernel developers doesn't guarantee that ;TI"Jreadability of select(2) means readability of following read(2) even ;TI"for single process. ;TI".See select(2) manual on GNU/Linux system.;T@o;
;	[I"]Invoking <code>IO.select</code> before <code>IO#readpartial</code> works well in usual. ;TI"BHowever it is not the best way to use <code>IO.select</code>.;T@o;
;	[
I"8The writability notified by select(2) doesn't show ;TI"how many bytes writable. ;TI"N<code>IO#write</code> method blocks until given whole string is written. ;TI"uSo, <code>IO#write(two or more bytes)</code> can block after writability is notified by <code>IO.select</code>. ;TI"F<code>IO#write_nonblock</code> is required to avoid the blocking.;T@o;
;	[I"?Blocking write (<code>write</code>) can be emulated using ;TI"H<code>write_nonblock</code> and <code>IO.select</code> as follows: ;TI"kIO::WaitReadable should also be rescued for SSL renegotiation in <code>OpenSSL::SSL::SSLSocket</code>.;T@o;;	[I"while 0 < string.bytesize
;TI"
 begin
;TI"2 written = io_like.write_nonblock(string)
;TI" rescue IO::WaitReadable
;TI" IO.select([io_like])
;TI" retry
;TI" rescue IO::WaitWritable
;TI"# IO.select(nil, [io_like])
;TI" retry
;TI" end
;TI". string = string.byteslice(written..-1)
;TI"	end
;T;
0S:RDoc::Markup::Heading:
leveli:	textI"Parameters;To:RDoc::Markup::List:
@type:	NOTE:@items[	o:RDoc::Markup::ListItem:@label[I"read_array;T;	[o;
;	[I"Gan array of <code>IO</code> objects that wait until ready for read;To;;[I"write_array;T;	[o;
;	[I"Han array of <code>IO</code> objects that wait until ready for write;To;;[I"error_array;T;	[o;
;	[I"Aan array of <code>IO</code> objects that wait for exceptions;To;;[I"timeout;T;	[o;
;	[I"a numeric value in second;T@S;;i;I"Example;T@o;;	[I"rp, wp = IO.pipe
;TI"mesg = "ping "
;TI"100.times {
;TI"H # IO.select follows IO#read. Not the best way to use IO.select.
;TI"' rs, ws, = IO.select([rp], [wp])
;TI" if r = rs[0]
;TI" ret = r.read(5)
;TI" print ret
;TI" case ret
;TI" when /ping/
;TI" mesg = "pong\n"
;TI" when /pong/
;TI" mesg = "ping "
;TI"
 end
;TI" end
;TI" if w = ws[0]
;TI" w.write(mesg)
;TI" end
;TI"}
;T;
0o;
;	[I"produces:;T@o;;	[
I"ping pong
;TI"ping pong
;TI"ping pong
;TI"(snipped)
;TI"	ping;T;
0:
@fileI"	io.c;T:0@omit_headings_from_table_of_contents_below0I"YIO.select(read_array
[, write_array
[, error_array
[, timeout]]]) -> array or nil
;T0[�I"$(p1, p2 = v2, p3 = v3, p4 = v4);T@�FI"Kernel;TcRDoc::NormalModule00