fdds_copy - DDS, copy one definition
SYNOPSIS
#include <fdds.h> (fixed-format sources)
#include <f90dds.h> (free-format sources)
integer function fdds_copy(alias)
-
character*(*) alias
DESCRIPTION
This function copies one definition from an input dictionary
to the output dictionary.
INPUT
Alias is a list of definition names,
delimited by white space.
A new definition is selected,
if one or more names are specified.
The first definition that matches any alias is selected.
Dictionary are scanned from bottom-to-top and right-to-left.
If no match is found, the copy is ignored and EOF is returned.
If an alias is not specified,
the current input definition is copied.
The entire value is copied,
regardless of the current position.
OUTPUT
Another input definition may be selected.
One Definition may be appended to the output dictionary.
The return value is the number of characters written,
or EOF if an error occurred.
Zero is returned if no output dictionaries are open.
EXAMPLE
! copy the "size" definition
j = fdds_copy('size')
SEE ALSO
fdds_history Copy all DDS definitions
AUTHOR
R. L. Selzler, EPTG (May, 1994)