xdr_string()--Translate between Strings and Their XDR

 #include <rpc/xdr.h>

 bool_t xdr_string(XDR *xdrs,
                   char **sp,
                   u_int maxsize);

The xdr_string() function is a filter primitive that translates between C-language strings and their corresponding external representations.

Parameters

xdrs  (Input) 

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

sp  (I/O) 

The address of the pointer to the string. If decoding and *sp==NULL, XDR allocated the storage needed for the decoded string.

maxsize  (Input) 

The maximum length of the string in bytes allowed during encoding or decoding.

Authorities

No authorization is required.

Return Value

Error Conditions

None.

Error Messages

Example

See Code disclaimer information for information pertaining to code examples.

The following example shows how xdr_string() is used:

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

#define MAX_LENGTH 100

typedef struct adress
{
        char  street[MAX_LENGTH];
        int   number;
        int   apartment;
} address ;

bool_t xdr_address(XDR *xdrs, address *p_address)
{
        if!(xdr_string(xdrs,&(p_address->street),
        MAX_LENGTH))
                return FALSE;
        if(!xdr_int(xdrs,&(p_address->number)))
                return FALSE;
        return xdr_int(xdrs,&(p_address->apartment));
}