Return to getequal.nr CVS log

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

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

1.1       root        1: .th GETEQUAL AM 9/12/77
                      2: .sh NAME
                      3: getequal - get the first tuple equal to the provided key
                      4: .sh SYNOPSIS
                      5: .nf
                      6: getequal(d, key, tuple, tid)
                      7: struct descriptor      *d;
                      8: char                   key[MAXTUP];
                      9: char                   tuple[MAXTUP];
                     10: struct tup_id          *tid;
                     11: .fi
                     12: .sh DESCRIPTION
                     13: GETEQUAL is used to do a keyed retrieval of a single
                     14: tuple in cases where the calling program knows the key to
                     15: be unique.  SETKEY must be called first to set all desired
                     16: domain values.  GETEQUAL will return the first tuple with
                     17: equality on all of the specified domains.
                     18: The tuple is returned in TUPLE.
                     19: .sh DIAGNOSTICS
                     20: .nf
                     21: AMFIND_ERR -- unidentifiable storage structure in find
                     22: AMWRITE_ERR -- pageflush failure
                     23: AMREAD_ERR -- get_page failure or invalid error
                     24: 0 -- success
                     25: 1 -- no match
                     26: .fi
                     27: .sh "TRACE FLAGS"
                     28: 23.8 - 23.10
                     29: .sh "SEE ALSO"
                     30: clearkeys, closer, find, get, openr, setkey

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