xdr_u_char()--Translate between Unsigned Characters and Their XDR


  Syntax
 #include <rpc/xdr.h>

 bool_t xdr_u_char(XDR *xdrs,
                   char *ucp);

  Service Program Name: QZNFTRPC

  Default Public Authority: *USE

  Threadsafe: No

The xdr_u_char() function is a filter primitive that translates between unsigned C-language characters and their external representations.


Parameters

xdrs  (Input) 
A pointer to the eXternal Data Representation (XDR) stream handle.

ucp  (I/O) 
A pointer to an unsigned 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_u_char() is used:

#include <stdio.h>
#include <xdr.h>
typedef struct grades
{
        u_char  math; /* Each grade is 'A'..'D' */
        u_char  literature;
         u_char  geography;
        u_char  computers;
} grades ;


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


API introduced: V4R2
Top | Remote Procedure Call (RPC) APIs | APIs by category