iswrite(S)                     6 January 1993                     iswrite(S)


 Name

    iswrite - write a new record into an ISAM file

 Syntax


    cc  . . .  -lisam


    iswrite (isfd, record)
    int isfd;
    char *record;


 Description

    The iswrite function writes a new record into an ISAM file.   You can use
    the following arguments with this routine:


    _________________________________________________________________________
    Argument                         Description
    _________________________________________________________________________
    isfd                             File descriptor identifying the ISAM
                                     file in which the record is being writ-
                                     ten.
    record                           Character buffer holding the data to be
                                     written into the file.

    When using iswrite, care must be taken to ensure values are located prop-
    erly in their fields in the record buffer prior to calling the function.

    If the function executes successfully, isrecnum is set to the new record.
    The current record position pointer is left unchanged.

    Any indexes are updated as needed.

    If the record contains any duplicate values in fields that are defined
    with NODUPS attribute, an error is produced and no record is written.

    On success, iswrite returns 0.  Otherwise, it returns -1 and sets iserrno
    to indicate the error.

 Example


       iswrite( bookfd, buffer ) ;


 See also

    iswrcurr(S)

 Standards conformance

    iswrite is not part of any currently supported standard; it is an exten-
    sion of AT&T System V provided by the Santa Cruz Operation.