put_xarg_str

Load a string into a subroutine argument

WTSupported in traditional Synergy on Windows

 

USupported on UNIX

 

void put_xarg_str(DESCRIP **argblock, int arg, char *string, int length)

Arguments

argblock

The argument block pointer passed by the Synergy DBL subroutine to the C function.

arg

The number of the argument to reference.

string

A pointer to the string to transfer.

length

The length of the string to transfer.

Discussion

The put_xarg_str function loads a string into a subroutine argument.

If the argument wasn’t passed, or if it’s a literal, the routine generates a trappable Synergy DBL error.

The argument’s field is loaded left‑justified over blanks.

On OpenVMS, the functionality of put_xarg_str is available as str_to_dscr. See the xcallv.h file for details. Its prototype is

void str_to_dscr(DESCRIP*, char *string, int length)