Return to replace.nr CVS log

Up to [CSRG BSD Unix] / 43BSD / ingres / doc / access

Annotation of 43BSD/ingres/doc/access/replace.nr, revision 1.1.1.1

1.1       root        1: .th REPLACE AM 9/14/77
                      2: .sh NAME
                      3: replace - modify an existing tuple
                      4: .sh SYNOPSIS
                      5: .nf
                      6: replace(d, tid, tuple, checkdups)
                      7: struct descriptor      *d;
                      8: struct tup_id          *tid;
                      9: char                   tuple[MAXTUP];
                     10: int                    checkdups;
                     11: .fi
                     12: .sh DESCRIPTION
                     13: REPLACE will replace the current value of the tuple identified
                     14: by TID with the new value in TUPLE.
                     15: CHECKDUPS has the same meaning for REPLACE as it does for INSERT.
                     16: See INSERT for description.
                     17: .sp
                     18: REPLACE will normally put the new tuple in the same
                     19: location occupied by the old tuple except if the
                     20: relation is compressed or if the value of a keyed
                     21: domain is changed.
                     22: This is necessary in the former case because compression
                     23: may give a tuple size different from the previous tuple,
                     24: while in the latter case a new key value for the tuple
                     25: may force the tuple to be located in a different section
                     26: of the relation so that it can be found by FIND.
                     27: The two exceptions are handled by calling DELETE
                     28: to remove the old tuple and calling INSERT to
                     29: add the new tuple.
                     30: .sh DIAGNOSTICS
                     31: .nf
                     32: AMFIND_ERR -- unidentifiable storage structure in find
                     33: AMWRITE_ERR -- write error
                     34: AMREAD_ERR -- read error
                     35: 0 -- success
                     36: 1 -- new tuple was a duplicate
                     37:      Tid is set to the tuple id of the duplicate
                     38: 2 -- tuple identified by tid has been deleted
                     39: .fi
                     40: .sh "TRACE FLAGS"
                     41: 24.4, 24.5, 24.6
                     42: .sh "SEE ALSO"
                     43: closer, delete, get, insert, openr

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.