---
name: "Sockets.recv"
section: "3kaya"
platform: "linux"
package: "kaya"
version: "0.4.4-6.2"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/Sockets.recv"
---

# Sockets.recv(3kaya)

Receive text data from a socket

## NAME

Sockets::recv - Receive text data from a socket

## SYNOPSIS

**String recv(** *Socket s, Int maxlen=-1, Int timeout=1000000* **)**

## ARGUMENTS

**s** The socket

**maxlen** The maximum number of bytes to receive. This must be a positive integer (the default is 1024), or -1 for no limit. Note that if the data to be received contains multi-byte characters, care must be taken to avoid ending receiving part-way through a multi-byte character.

**timeout** The time to wait for data in microseconds before giving up (the default is 1000000, or 1 second). -1 can be used to wait until data arrives.

## DESCRIPTION

Receive text data from a socket.

## AUTHORS

Kaya standard library by Edwin Brady, Chris Morris and others (kaya@kayalang.org). For further information see http://kayalang.org/

## LICENSE

The Kaya standard library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License (version 2.1 or any later version) as published by the Free Software Foundation.

## RELATED

**Sockets.Socket (3kaya)**

**Sockets.pending (3kaya)**

**Sockets.send (3kaya)**

**Sockets.recvByte (3kaya)**

**Sockets.recvBytes (3kaya)**