NAME

putch - put argument in output history file


SYNOPSIS

  int putch(name, format, val)


INPUT PARAMETERS

name -char*
      parameter name
format - char
      format of variable (d,f,s)
val- void*
      variable value of variable


RETURN VALUE

0 = if sucessful


DESCRIPTION

This function is a seplib companion to the input routines fetch, getch, and hetch that appends values to the output history file with expressions of the form `name=value'.


COMMENTS

Possible format conversions are ``d'' (or ``i''), ``f'' (or ``r''), ``g'' and ``s'' for integer, floating point, double precision, and strings respectively.

These values may be diverted from the default history file on standard output with the command line parameter `head=filename'.


EXAMPLES

From C:

putch ( ``intpar'', ``i'', &int);

putch ( ``intpar2'', ``d'', &int);

putch ( ``float'', ``f'', &float);

putch ( ``floatpar'', ``r'', &float);

putch ( ``somename'', ``s'', ``name'');

From Fortran:

call putch ( 'intpar', 'i', int)

call putch ( 'intpar2', 'd', int)

call putch ( 'floatpar', 'f', float)

call putch ( 'float', 'r', float)

call putch ( 'somename', 's', 'name')


SEE ALSO

the getch manpage, the fetch manpage, the hetch manpage, the puthead manpage


DIAGNOSTICS

Program execution is terminated when an invalid format is passed.


BUGS

It is not presently possible to specify multiple output names in one call as can presently be done on input with fetch, etc.


KEYWORDS

parameter output


LIBRARY

sep