/////////////////////////////////////////////////////////////////////////////
// File: CLIPSYM.DOC
// Author:Ian VertliebDate: May 7, 1991
// Copyright (c) 1990,1991 Baldwin Computer Services, All Rights Reserved.
/////////////////////////////////////////////////////////////////////////////

CLIPSYM.LIB conatins a few routines to access the Clipper's runtime symbol
table. In addition, ASEARCH is a binary ASCAN replacement.

/////////////////////////////////////////////////////////////////////////////
// ASEARCH - A binary search replacement for ASCAN
/////////////////////////////////////////////////////////////////////////////
Usage: ASEARCH(aSource, cValue) or ASEARCH(aSource, nValue)

Description: Clipper's array search facility ASCAN performs a linear search
of an array. In contrast, ASEARCH performs a binary search on a sorted array,
and is usually faster than ASCAN.

Returns: Returns the value's position in the array or 0 if not found.

Note: The array must be composed entirley of strings (for a string search) or
integers (for a numeric search) and must be sorted in ascending order.

CLIPPER Runtime Symbol Table Access Functions
---------------------------------------------
Clipper's runtime symbol table is used to determine whether a symbol exists
or not. This function could be used for an interpretor, or to prevent
runtime errors.

/////////////////////////////////////////////////////////////////////////////
// ISSYMBOL - Determines whether a symbol exists or not
/////////////////////////////////////////////////////////////////////////////
Usage: ISSYMBOL(cSymbol)
Returns: logical .t. if found, .f. if undefined

/////////////////////////////////////////////////////////////////////////////
// ISVARIABLE - Determines whether a symbol is a variable
/////////////////////////////////////////////////////////////////////////////
Usage: ISVARIABLE(cSymbol)
Returns: logical .t. if found, .f. if undefined

/////////////////////////////////////////////////////////////////////////////
// ISFUNCTION - Determines whether a symbol is a function or procedure
/////////////////////////////////////////////////////////////////////////////
Usage: ISFUNCTION(cSymbol)
Returns: logical .t. if found, .f. if undefined