int newheader(char *record)
Return:
This function creates a `header' file (in the current directory).
Use newheader
just after you have finished writing the signal
files, but before calling dbquit
. If record begins with
`+', the `+' is discarded and the remainder of record is
taken as the record name. Otherwise, all of record is taken to be
the record name. If the record name is `-', the `header' file
is written to the standard output. Record names may include letters in
lower or upper case, digits, and underscores (`_'); they may not
include any other characters. If record does not conform to these
requirements, newheader
will return
-1;
see section Example 8: Creating a New Database Record,
for an illustration of the use of newheader
to check the validity
of a record name. For compatibility with the widest range of operating
systems, keep record names short (6 characters or less) and avoid those
that are distinguished by case alone. To avoid confusion with MIT DB
and AHA DB records, do not use three- or four-digit record names.
Go to the first, previous, next, last section, table of contents.