WOLFRAM

Wolfram Language & System Documentation Center
Wolfram Language Home Page »

SocketReadyQ
✖
SocketReadyQ

Unsupported in Public Cloud

✖
SocketReadyQ[socket]

tests if there is any data immediately available to read from the specified socket.

✖
SocketReadyQ[socket,t]

waits for up to t seconds to see if data becomes available to read.

Details

  • Sockets in SocketReadyQ[…] are specified using SocketObject[…].
  • SocketReadyQ returns immediately; unlike Read etc., it does not block waiting for data to become available.
  • For numeric values, t is interpreted as having units of seconds. A time Quantity can also be used.

Examples

open allclose all

Basic Examples  (3)Summary of the most common use cases

Initially on connection, most websites will not send data until a request is made:

In[1]:=1
✖
https://wolfram.com/xid/0bh0pmuaocx1i7-3xoguq
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0bh0pmuaocx1i7-h1qmhu
Out[2]=2

Write a request to the socket and wait for up to 10 seconds for the server's response to arrive:

In[3]:=3
✖
https://wolfram.com/xid/0bh0pmuaocx1i7-n6fayl
Out[3]=3

Close the socket:

In[4]:=4
✖
https://wolfram.com/xid/0bh0pmuaocx1i7-1ovdk
Out[4]=4

Open a server socket and connect a client socket to it:

In[1]:=1
✖
https://wolfram.com/xid/0bh0pmuaocx1i7-o0tua6
Out[1]=1
Out[1]=1

Initially, neither of them has any data available:

In[2]:=2
✖
https://wolfram.com/xid/0bh0pmuaocx1i7-wle1sa
Out[2]=2

Sending a message to the client makes the socket ready for reading:

In[3]:=3
✖
https://wolfram.com/xid/0bh0pmuaocx1i7-i9jbx6
Out[3]=3

After reading the message, there is no more data available:

In[4]:=4
✖
https://wolfram.com/xid/0bh0pmuaocx1i7-vmohxb
Out[4]=4

Close the sockets:

In[5]:=5
✖
https://wolfram.com/xid/0bh0pmuaocx1i7-rewd6b
Out[5]=5

Wait for a response using a Quantity as the second argument:

In[1]:=1
✖
https://wolfram.com/xid/0bh0pmuaocx1i7-1td7cf
Out[1]=1

Close the socket:

In[2]:=2
✖
https://wolfram.com/xid/0bh0pmuaocx1i7-wc95os
Out[2]=2

Neat Examples  (1)Surprising or curious use cases

Make a simple ping time function, measuring how long it takes for an HTTP response to come back:

In[1]:=1
✖
https://wolfram.com/xid/0bh0pmuaocx1i7-ba3c50

Ping a host to see how long before it responds:

In[2]:=2
✖
https://wolfram.com/xid/0bh0pmuaocx1i7-t2u8rj
Out[2]=2

Request the page multiple times:

In[3]:=3
✖
https://wolfram.com/xid/0bh0pmuaocx1i7-rufj53
Out[3]=3
Wolfram Research (2017), SocketReadyQ, Wolfram Language function, https://reference.wolfram.com/language/ref/SocketReadyQ.html.
✖
Wolfram Research (2017), SocketReadyQ, Wolfram Language function, https://reference.wolfram.com/language/ref/SocketReadyQ.html.

Text

Wolfram Research (2017), SocketReadyQ, Wolfram Language function, https://reference.wolfram.com/language/ref/SocketReadyQ.html.

✖
Wolfram Research (2017), SocketReadyQ, Wolfram Language function, https://reference.wolfram.com/language/ref/SocketReadyQ.html.

CMS

Wolfram Language. 2017. "SocketReadyQ." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/SocketReadyQ.html.

✖
Wolfram Language. 2017. "SocketReadyQ." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/SocketReadyQ.html.

APA

Wolfram Language. (2017). SocketReadyQ. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/SocketReadyQ.html

✖
Wolfram Language. (2017). SocketReadyQ. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/SocketReadyQ.html

BibTeX

@misc{reference.wolfram_2025_socketreadyq, author="Wolfram Research", title="{SocketReadyQ}", year="2017", howpublished="\url{https://reference.wolfram.com/language/ref/SocketReadyQ.html}", note=[Accessed: 29-March-2025 ]}

✖
@misc{reference.wolfram_2025_socketreadyq, author="Wolfram Research", title="{SocketReadyQ}", year="2017", howpublished="\url{https://reference.wolfram.com/language/ref/SocketReadyQ.html}", note=[Accessed: 29-March-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_socketreadyq, organization={Wolfram Research}, title={SocketReadyQ}, year={2017}, url={https://reference.wolfram.com/language/ref/SocketReadyQ.html}, note=[Accessed: 29-March-2025 ]}

✖
@online{reference.wolfram_2025_socketreadyq, organization={Wolfram Research}, title={SocketReadyQ}, year={2017}, url={https://reference.wolfram.com/language/ref/SocketReadyQ.html}, note=[Accessed: 29-March-2025 ]}