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;

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.