Writes a buffer of data to a file or socket.

Syntax

#include <prio.h>

PRInt32 PR_Write(
  PRFileDesc *fd,
  const void *buf,
  PRInt32 amount);

Parameters

The function has the following parameters:

fd

A pointer to the PRFileDesc object for a file or socket.

buf

A pointer to the buffer holding the data to be written.

amount

The amount of data, in bytes, to be written from the buffer.

Returns

One of the following values:

• A positive number indicates the number of bytes successfully written.
• The value -1 indicates that the operation failed. The reason for the failure is obtained by calling PR_GetError.

Description

The thread invoking PR_Write blocks until all the data is written or the write operation fails. Therefore, the return value is equal to either amount (success) or -1 (failure). Note that if PR_Write returns -1, some data (less than amount bytes) may have been written before an error occurred.