getcx Kernel Service
Purpose
Returns the character at the end of a designated list.
Syntax
#include <sys/types.h>
#include <sys/errno.h>
#include <cblock.h>int getcx ( header)
struct clist *header;
struct clist *header;
Parameter
| Item | Description |
|---|---|
| header | Specifies the address of the clist structure that describes the character list. |
Description
Attention: The caller of the getcx service must ensure that the character list is pinned. This includes the clist header and all the cblock character buffers. Character buffers acquired from the getcf service are pinned.
The getcx kernel service is identical to the getc service, except that the getcx service returns the character at the end of the list instead of the character at the front of the list. The character at the end of the list is the last character in the first buffer, not in the last buffer.
Execution Environment
The getcx kernel service can be called from either the process or interrupt environment.
Return Values
The getcx service returns the character at the end of the list instead of the character at the front of the list.