Go to the first, previous, next, last section, table of contents.


newheader

int newheader(char *record)

Return:

0
Success
-1
Failure: unable to create `header' file

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.



George B. Moody (george@hstbme.mit.edu)