xdr_char()--Translate between Characters and Their XDR

Syntax

 #include <rpc/xdr.h>

 bool_t xdr_char(XDR *xdrs,
                 char *cp);

  Service Program Name: QZNFTRPC

  Default Public Authority: *USE

  Threadsafe: No

The xdr_char() function is a filter primitive that translates between C-language characters and their external representation.

Note: Encoded characters are not packed and occupy 4 bytes each. For strings of characters, consider using the xdr_string function.

Parameters

xdrs (Input): A pointer to the External Data Representation (XDR) stream handle.
cp (I/O): A pointer to the character.

Authorities

No authorization is required.

Return Value

TRUE (1)	Successful
FALSE (0)	Unsuccessful

Error Conditions

None.

Error Messages

Message ID	Error Message Text
CPE3418 E	Possible APAR condition or hardware failure.
CPF3CF2 E	Error(s) occurred during running of &1 API.
CPF9872 E	Program or service program &1 in library &2 ended. Reason code &3.

Example

The following example shows how xdr_char() is used.

Note: By using the code examples, you agree to the terms of the Code license and disclaimer information.

#include <stdio.h>
#include <xdr.h>

typedef struct grades
{
        char  math; /* Each grade is 'A'..'D' */
        char  literature;
         char  geography;
        char  computers;
} grades ;


bool xdr_grades(XDR *xdrs, grades *p_grades)
{
        if(!xdr_char(xdrs,&(p_grades->math)))
                return FALSE;
        if(!xdr_char(xdrs,&(p_grades->literature)))
                return FALSE;
        if(!xdr_char(xdrs,&(p_grades->geography)))
                return FALSE;
        return xdr_char(xdrs,&(p_grades->computers));
}

API introduced: V4R2

[ Back to top | Remote Procedure Call (RPC) APIs | APIs by category ]