---
name: "mongoc_stream_write"
section: "3"
platform: "linux"
package: "libmongoc-doc"
version: "1.30.4-1+deb13u3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/mongoc_stream_write"
---

# mongoc\_stream\_write(3)

## SYNOPSIS

```
ssize_t
mongoc_stream_write (mongoc_stream_t *stream,
                     void *buf,
                     size_t count,
                     int32_t timeout_msec);
```

## PARAMETERS

- •

  **stream**: A *mongoc\_stream\_t*.

- •

  **buf**: The buffer to write.

- •

  **count**: The number of bytes to write.

- •

  **timeout\_msec**: The number of milliseconds to wait before failure, a timeout of 0 will not block. If negative, use the default timeout.

The *mongoc\_stream\_write()* function shall perform a write to a *mongoc\_stream\_t*. It's modeled on the API and semantics of **write()**, though the parameters map only loosely.

**WARNING:**

The "default timeout" indicated by a negative value is both unspecified and unrelated to the documented default values for **\*TimeoutMS** URI options. To specify a default timeout value for a **\*TimeoutMS** URI option, use the **MONGOC\_DEFAULT\_\*** constants defined in **mongoc-client.h**.

## RETURNS

The *mongoc\_stream\_write()* function returns the number of bytes written on success. It returns **-1** and sets **errno** upon failure.

**SEE ALSO:**

```
mongoc_stream_read()
```

```
mongoc_stream_readv()
```

```
mongoc_stream_writev()
```

## AUTHOR

MongoDB, Inc

## COPYRIGHT

2009-present, MongoDB, Inc.