Click above to get retro games delivered to your door ever month!

Alphabetical Listing of Library Functions

   This section describes the C library functions, which are arranged
   broadly in alphabetical order. Underscores are ignored in determining
   this order. Some functions share common descriptions (e.g. FP_OFF and
   FP_SEG), and in such cases the alphabetical order is determined by the
   first in the group. All functions, including those described in other
   chapters, are listed in the index at the back of the manual, where
   underscores are taken into account in the sequence.

   Users should note that the order departs from being strictly alphabetical
   so as to keep together those functions which are part of the same package
   - an example of this is the fg_ functions in the Flash Graphics package.
   Functions grouped in this way are distinguished by lighter separating
   horizontal rules.

   Each alphabetical group of functions starts on a new right hand page,
   which means that you will find some left hand pages left intentionally
   blank.

   The function descriptions have a number of sub-headings; here is a
   description of each one:

Function Name

   Each library function begins with the function name, which appears in the
   proper case to be used in a C or C++ program, including any leading
   underscores and capital letters. It is important to observe the case used
   for a function because printf and PRINTF are not equivalent.

Usage

   First is the compiler directive #include <filename.h>. The identifier
   filename.h is the name of the header file containing the prototype of the

   function. The prototype declares the data type for return values and
   arguments passed to a function. Header files can also contain types,
   structures, and constant definitions to be used by a function. Header
   files are typically included at the beginning of the program prior to the
   first function.

   Following the directive is the function prototype. It appears in largely
   the same form as declared in the header file. The appropriate header file
   must be included for any function that is used in C++. It is highly
   recommended that you include it even if you are only using the C
   compiler, to ensure proper type-checking of function arguments and return
   types.

Description

   Encapsulates what the function is intended to do. It describes the
   arguments that are to be passed to the function and any other details
   needed to use the function correctly.

Example


   In most cases a complete stand alone executable example is presented
   which you may type in and execute. Each example includes all header files
   needed by the functions used. In some cases it is not practical to
   include a full example, for example, the Flash Graphics library
   functions. In that case a meaningful partial example is given.

Return Value

   Explains any value returned by a function. In many cases the return value
   indicates success or failure. If this entry is omitted it means that
   there is no return value from the function.

See Also

   Lists other related or complementary functions.