NAME

linear_search - Finds an element in an array

SYNOPSIS

#include "l/l_sort.h"

Example compile flags (system dependent):
  -DLINUX_386 -DLINUX_386_P4  
   -I/home/kobus/include
   -L/home/kobus/load/linux_386_p4 -L/usr/local/lib -L/usr/lib
  -lKJB         -llapack -lblas -lg2c          -lXext -lX11 


int linear_search
(
	const void *array,
	int num_elements,
	size_t element_size,
	int (*cmp_fn)(const void *,const void *),
	const void *search_key_ptr
);

DESCRIPTION

This routine finds an element (pointed to by search_key_ptr) in the array "array" with a linear search. The array need not be sorted. The search is done with the compare routine "cmp_fn".

RETURNS

On success, this routine returns an index into the array. If the element is not found, then it returns NOT_FOUND.

DISCLAIMER

This software is not adequatedly tested. It is recomended that results are checked independantly where appropriate.

AUTHOR

Kobus Barnard

DOCUMENTOR

Kobus Barnard

SEE ALSO

kjb_sort , int_sort , long_sort , binary_search , int_binary_search , long_binary_search , binary_search_int_array , binary_search_long_array , int_linear_search , long_linear_search , linear_search_int_array , linear_search_long_array