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

See Code disclaimer information for information pertaining to code examples.

The following example shows how xdr_char() is used:

#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
Top | Remote Procedure Call (RPC) APIs | APIs by category