Linux heracles.o2switch.net 4.18.0-553.62.1.lve.el8.x86_64 #1 SMP Mon Jul 21 17:50:35 UTC 2025 x86_64
/
opt
/
alt
/
ruby21
/
share
/
ri
/
2.1.0
/
system
/
Socket
/
//opt/alt/ruby21/share/ri/2.1.0/system/Socket/recvfrom_nonblock-i.ri
U:RDoc::AnyMethod[iI"recvfrom_nonblock:ETI"Socket#recvfrom_nonblock;TF:publico:RDoc::Markup::Document:@parts[o:RDoc::Markup::Paragraph; [I"IReceives up to _maxlen_ bytes from +socket+ 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"OThe second element, _sender_addrinfo_, contains protocol-specific address ;TI"information of the sender.;To:RDoc::Markup::BlankLine o; ; [I"BWhen recvfrom(2) returns 0, Socket#recvfrom_nonblock returns ;TI"an empty string as data. ;TI"MThe meaning depends on the socket: EOF on TCP, empty packet on UDP, etc.;T@S:RDoc::Markup::Heading: leveli: textI"Parameters;To:RDoc::Markup::List: @type:BULLET:@items[o:RDoc::Markup::ListItem:@label0; [o; ; [I"F+maxlen+ - the maximum number of bytes to receive from the socket;To;;0; [o; ; [I"1+flags+ - zero or more of the +MSG_+ options;T@S;; i;I"Example;To:RDoc::Markup::Verbatim; [ I"%# In one file, start this first ;TI"require 'socket' ;TI"include Socket::Constants ;TI"2socket = Socket.new(AF_INET, SOCK_STREAM, 0) ;TI"6sockaddr = Socket.sockaddr_in(2200, 'localhost') ;TI"socket.bind(sockaddr) ;TI"socket.listen(5) ;TI"-client, client_addrinfo = socket.accept ;TI"'begin # emulate blocking recvfrom ;TI"+ pair = client.recvfrom_nonblock(20) ;TI"rescue IO::WaitReadable ;TI" IO.select([client]) ;TI" retry ;TI" end ;TI"data = pair[0].chomp ;TI"/puts "I only received 20 bytes '#{data}'" ;TI" sleep 1 ;TI"socket.close ;TI" ;TI"*# In another file, start this second ;TI"require 'socket' ;TI"include Socket::Constants ;TI"2socket = Socket.new(AF_INET, SOCK_STREAM, 0) ;TI"6sockaddr = Socket.sockaddr_in(2200, 'localhost') ;TI"socket.connect(sockaddr) ;TI"-socket.puts "Watch this get cut short!" ;TI"socket.close ;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"XSocket#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::AGAIN, ;TI")it is extended by IO::WaitReadable. ;TI"]So IO::WaitReadable can be used to rescue the exceptions for retrying recvfrom_nonblock.;T@S;; i;I"See;To;;;;[o;;0; [o; ; [I"Socket#recvfrom;T: @fileI"ext/socket/socket.c;T:0@omit_headings_from_table_of_contents_below0I"socket.recvfrom_nonblock(maxlen) => [mesg, sender_addrinfo] socket.recvfrom_nonblock(maxlen, flags) => [mesg, sender_addrinfo] ;T0[ I"(*args);T@\FI"Socket;TcRDoc::NormalClass00