SDFTOUCH(3SDF)

NAME
sdftouch - functions to set the modification date of a seadif object.

SYNOPSIS
 #include <sealib.h>
 int sdftouchlay(LAYOUTPTR lay, time_t timestamp);
 int sdftouchcir(CIRCUITPTR cir, time_t timestamp);
 int sdftouchlib(LIBRARYPTR lib, time_t timestamp);
 int sdftouchfun(FUNCTIONPTR fun, time_t timestamp);

DESCRIPTION
If the named seadif object does not yet exist in the database it is created, similar to sdfwrite(3SDF), and the modification date in the Status field is set to timestamp. If the named seadif object already exists in the database, then sdftouch sets the modification date of the object to timestamp. Because of run time efficiency, this modifiction date is not written to the seadif database. As a consequence, the programmer must call sdfwrite(3SDF) before closing the database, otherwise the call to sdftouch has no effect.

RETURN VALUE
These functions return TRUE if the date could be set, NIL otherwise.

AUTHOR
Paul Stravers, Delft University of Technology. E-mail address is ocean@donau.et.tudelft.nl.

SEE ALSO
sdfwrite(3SDF), seadif(4SDF)