int SDLNet_UDP_RecvV(UDPsocket sock, UDPpacket **packets)
sock | パケットを受信するUDPソケット |
packets | NULL終端のパケット配列 |
戻されたパケットには通信元アドレスと受信したチャネルが含まれている. バインドしたチャネルに到着しなかった場合, チャネルには-1がセットされている.
チャネルは上から下の順にチェックされる. そのため, アドレスが複数のチャネルにバインドされている場合, アドレスがバインドされた最も高いチャネルが戻される.
この関数はパケットの配列を入力とするが, SDLNet_AllocPacketV()で確保したものでなくてもよい. 自分で確保した個々のパケットの配列でも, 配列の末尾がNULLであればSDL_netが配列の終端を知ることができるため可能である. SDLNet_AllocPacketV()から戻された配列の終端にはNULLが書き込まれている.
この関数はブロックしない. そのためパケットがない場合があるが, これはエラーではない.