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 ]