PR_Write

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.

Document Tags and Contributors

 Contributors to this page: teoli, alecananian
 Last updated by: teoli,