isrewrec(S)                    6 January 1993                    isrewrec(S)


 Name

    isrewrec - rewrite the record indicated by record number

 Syntax


    cc  . . .  -lisam


    isrewrec(isfd, recnum, record)
    int isfd;
    long recnum;
    char *record;


 Description

    The isrewrec function rewrites a record specified by its record number.
    The record number recnum is a previously obtained isrecnum value.  You
    can use the following arguments with this routine:


    _________________________________________________________________________
    Argument                       Description
    _________________________________________________________________________
    isfd                           File descriptor identifying the ISAM file
                                   containing the record to be updated.
    recnum                         Record number of the record to be updated.
    record                         Character buffer whose contents are writ-
                                   ten into the file.

    The record buffer should be loaded with the new data before the call is
    issued.  Care must be taken to ensure that fields are located properly in
    the buffer.

    Each index defined on the data file, including the primary index, is
    updated as needed.  On return, isrecnum is set to recnum, and the current
    record position is unchanged.

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

 Example


       isrewrec( bookfd, isrecnum, buffer ) ;


 See also

    isrewrite(S), isrewcurr(S)

 Standards conformance

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