Ultrix-3.1/src/libc/sysV/lsearch.c
/**********************************************************************
* Copyright (c) Digital Equipment Corporation 1984, 1985, 1986. *
* All Rights Reserved. *
* Reference "/usr/src/COPYRIGHT" for applicable restrictions. *
**********************************************************************/
/* SCCSID: @(#)lsearch.c 3.0 4/22/86 */
/* (System 5) 1.8 */
/* 3.0 SID # 1.2 */
/*LINTLIBRARY*/
/*
* Linear search algorithm, generalized from Knuth (6.1) Algorithm Q.
*
* This version no longer has anything to do with Knuth's Algorithm Q,
* which first copies the new element into the table, then looks for it.
* The assumption there was that the cost of checking for the end of the
* table before each comparison outweighed the cost of the comparison, which
* isn't true when an arbitrary comparison function must be called and when the
* copy itself takes a significant number of cycles.
* Actually, it has now reverted to Algorithm S, which is "simpler."
*/
typedef char *POINTER;
extern POINTER memcpy();
POINTER
lsearch(key, base, nelp, width, compar)
register POINTER key; /* Key to be located */
register POINTER base; /* Beginning of table */
unsigned *nelp; /* Pointer to current table size */
register unsigned width; /* Width of an element (bytes) */
int (*compar)(); /* Comparison function */
{
register POINTER next = base + *nelp * width; /* End of table */
for ( ; base < next; base += width)
if ((*compar)(key, base) == 0)
return (base); /* Key found */
++*nelp; /* Not found, add to table */
return (memcpy(base, key, (int)width)); /* base now == next */
}