1#@!#!123s

��JFIF�� 1#@!#!123s
: / opt / alt / ruby34 / share / ri / system / UDPSocket /
Filename : recvfrom_nonblock-i.ri
back
U:RDoc::AnyMethod[iI"recvfrom_nonblock:ETI" UDPSocket#recvfrom_nonblock;TF:publico:RDoc::Markup::Document:@parts[o:RDoc::Markup::Paragraph;	[
I"LReceives up to _maxlen_ bytes from +udpsocket+ using recvfrom(2) after ;TI";O_NONBLOCK is set for the underlying file descriptor. ;TI"4_flags_ is zero or more of the +MSG_+ options. ;TI"EThe first element of the results, _mesg_, is the data received. ;TI"YThe second element, _sender_inet_addr_, is an array to represent the sender address.;To:RDoc::Markup::BlankLine�o;
;	[	I"CWhen recvfrom(2) returns 0, Socket#recv_nonblock returns nil. ;TI"LIn most cases it means the connection was closed, but it may also mean ;TI"?an empty packet was received, as the underlying API makes ;TI"2it impossible to distinguish these two cases.;T@S:RDoc::Markup::Heading:
leveli:	textI"Parameters;To:RDoc::Markup::List:
@type:BULLET:@items[	o:RDoc::Markup::ListItem:@label0;	[o;
;	[I">+maxlen+ - the number of bytes to receive from the socket;To;;0;	[o;
;	[I"1+flags+ - zero or more of the +MSG_+ options;To;;0;	[o;
;	[I")+outbuf+ - destination String buffer;To;;0;	[o;
;	[I"<+options+ - keyword hash, supporting `exception: false`;T@S;;
i;I"Example;To:RDoc::Markup::Verbatim;	[I"require 'socket'
;TI"s1 = UDPSocket.new
;TI"s1.bind("127.0.0.1", 0)
;TI"s2 = UDPSocket.new
;TI"s2.bind("127.0.0.1", 0)
;TI")s2.connect(*s1.addr.values_at(3,1))
;TI")s1.connect(*s2.addr.values_at(3,1))
;TI"s1.send "aaa", 0
;TI"'begin # emulate blocking recvfrom
;TI"i  p s2.recvfrom_nonblock(10)  #=> ["aaa", ["AF_INET", 33302, "localhost.localdomain", "127.0.0.1"]]
;TI"rescue IO::WaitReadable
;TI"  IO.select([s2])
;TI"
  retry
;TI"	end
;T:@format0o;
;	[I"PRefer to Socket#recvfrom for the exceptions that may be thrown if the call ;TI""to _recvfrom_nonblock_ fails.;T@o;
;	[I"[UDPSocket#recvfrom_nonblock may raise any error corresponding to recvfrom(2) failure, ;TI""including Errno::EWOULDBLOCK.;T@o;
;	[I">If the exception is Errno::EWOULDBLOCK or Errno::EAGAIN, ;TI")it is extended by IO::WaitReadable. ;TI"]So IO::WaitReadable can be used to rescue the exceptions for retrying recvfrom_nonblock.;T@o;
;	[I"OBy specifying a keyword argument _exception_ to +false+, you can indicate ;TI"Pthat recvfrom_nonblock should not raise an IO::WaitReadable exception, but ;TI"0return the symbol +:wait_readable+ instead.;T@S;;
i;I"See;To;;;;[o;;0;	[o;
;	[I"Socket#recvfrom;T:
@fileI"ext/socket/lib/socket.rb;T:0@omit_headings_from_table_of_contents_below0I"eudpsocket.recvfrom_nonblock(maxlen [, flags[, outbuf [, options]]]) => [mesg, sender_inet_addr]
;T0[�I"3(len, flag = 0, outbuf = nil, exception: true);T@^FI"UDPSocket;TcRDoc::NormalClass00