Technical Reference: Communications, Volume 1

xdr_string Subroutine

Purpose

Translates between C language strings and their external representations.

Syntax

#include <rpc/xdr.h>

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

The xdr_string subroutine is a filter primitive that translates between C language strings and their corresponding external representations. Externally, strings are represented as sequences of ASCII characters, while internally, they are represented with character pointers.

Parameters

xdrs	Points to the eXternal Data Representation (XDR) stream handle.
sp	Specifies the address of the pointer to the string.
maxsize	Specifies the maximum length of the string allowed during encoding or decoding. This value is set in a protocol. For example, if a protocol specifies that a file name cannot be longer than 255 characters, then a string cannot exceed 255 characters.

Return Values

Upon successful completion, this subroutine returns a value of 1. If unsuccessful, it returns a value of 0.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

List of XDR Programming References.

eXternal Data Representation (XDR) Overview for Programming and Understanding XDR Library Filter Primitives in AIX 5L Version 5.1 Communications Programming Concepts.