PR_Send

NSPR
About NSPR
NSPR API Reference
NSPR Build Instruction
NSPR Release Process
Introduction to NSPR
NSPR Types
Threads
1. Threading Types and Constants
2. Threading Functions
Process Initialization
Locks
1. Lock Type
2. Lock Functions
Condition Variables
1. Condition Variable Type
2. Condition Variable Functions
Monitors
1. Monitor Type
2. Monitor Functions
Cached Monitors
1. Cached Monitor Functions
I/O Types
I/O Functions
Network Addresses
1. Network Address Types and Constants
2. Network Address Functions
Atomic Operations
Interval Timing
1. Interval Time Type and Constants
2. Interval Functions
Date and Time
Memory Management Operations
1. Memory Allocation Functions
2. Memory Allocation Macros
String Operations
Floating Point Number to String Conversion
Linked Lists
1. Linked List Types
  1. PRCList
2. Linked List Macros
Dynamic Library Linking
Process Management and Interprocess Communication
1. Process Management Types and Constants
  1. PRProcess
  2. PRProcessAttr
2. Process Management Functions
  1. Setting the Attributes of a New Process
  2. Creating and Managing Processes
Logging
Named Shared Memory
1. Shared Memory Protocol
2. Named Shared Memory Functions
Anonymous Shared Memory
1. Anonymous Memory Protocol
2. Anonymous Shared Memory Functions
IPC Semaphores
1. IPC Semaphore Functions
Thread Pools
1. Thread Pool Types
2. Thread Pool Functions
Random Number Generator
1. Random Number Generator Function
Hash Tables
1. Hash Tables and Type Constants
2. Hash Table Functions
NSPR Error Handling
Contribute
2. The MDN Project

Sends bytes from a connected socket.

Syntax

#include <prio.h>

PRInt32 PR_Send(
  PRFileDesc *fd,
  const void *buf,
  PRInt32 amount,
  PRIntn flags,
  PRIntervalTime timeout);

Parameters

The function has the following parameters:

fd: A pointer to a PRFileDesc object representing a socket.
buf: A pointer to a buffer containing the data to be sent.
amount: The size of buf (in bytes).
flags: This obsolete parameter must always be zero.
timeout: A value of type PRIntervalTime specifying the time limit for completion of the receive operation.

Returns

The function returns one of the following values:

A positive number indicates the number of bytes successfully sent. If the parameter fd is a blocking socket, this number must always equal amount.
The value -1 indicates a failure. The reason for the failure can be obtained by calling PR_GetError.

Description

PR_Send blocks until all bytes are sent, a timeout occurs, or an error occurs.