isrewrite(S)                   6 January 1993                   isrewrite(S)


 Name

    isrewrite - rewrite a record identified by its primary key

 Syntax


    cc ... -lisam


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


 Description

    The isrewrite function rewrites a record specified by its primary key
    when the primary key does not allow duplicate values.  You can use the
    following arguments with this routine:


    _________________________________________________________________________
    Argument                         Description
    _________________________________________________________________________
    isfd                             File descriptor identifying the ISAM
                                     file containing the record to be
                                     updated.
    record                           Character buffer whose contents are
                                     written into the file.  The primary key
                                     field identifies the record to be
                                     updated.

    The record buffer should be loaded with the new data before the isrewrite
    call is issued.  The primary key field must match that of the record to
    be updated.  Care must be taken to ensure that fields are located prop-
    erly in the buffer.

    Each index defined on the data file, including the primary index, is
    updated as needed.

    On return, isrecnum is set to the rewritten record, and the current
    record position is unchanged.

    On success, isrewrite returns a positive integer.  Otherwise, it returns
    -1 and sets iserrno to indicate the error.

 Example


       isrewrite( bookfd, buffer ) ;


 See also

    isrewrec(S), isrewcurr(S)

 Standards conformance

    isrewrite is not part of any currently supported standard; it is an
    extension of AT&T System V provided by the Santa Cruz Operation.