Home / Autodocs / rexxsyslib.library

NAME

GetRexxBufferFromMsg: retrieve the value of a Rexx variable (V47)

SYNOPSIS

error = GetRexxBufferFromMsg(var,msg,out,size)

A0 A2 A1 D0

LONG GetRexxBufferFromMsg(const UBYTE *var,const struct Message *msg,

UBYTE *buffer)

FUNCTION

Retrieves the value of an ARexx variable whose name is given as first argument, and places its length into the output buffer of the given size.

INPUTS

var: Name of the variable to be read. A stem variable is fine.
msg: Pointer to a rexx message received by this program defining the execution environment from which the variable is read.
out: buffer to hold the value of the variable.
size: size of the buffer in characters (including NUL)

RESULT

error: an error code from <rexx/errors.h> or 0 for success.

SEE ALSO

GetRexxVarFromMsg(), SetRexxVarFromMsg(), GetRexxVar() in amiga.lib

BUGS

This function only supports NUL-terminated values (which is, however, generally the case).