C02/include/stdlib.h02

/*********************************************
 * stdlib - Standard Library Routines for C02 *
 *********************************************/

/* Terminate Program Abnormally */
//void abort();

/* Terminate Program Normally */
//void exit();

/* Absolute Value                          *
 * Args: b - Byte to get absolute value of *
 * Returns: Absolute value of b            */
char abs();

/* Convert ASCII String to Unsigned Byte *
 * Args: &s - String to Convert          *
 * Returns: Numeric value of string      *
 *          Number of digits parsed      */
char atoc();

/* Convert Unsigned Byte to ASCII String *
 * Args: c  - Unsigned Byte to Convert   *
 *       &s - String to populate         *
 * Returns: Length of string             */
void ctoa();

/* Divide Unsigned Bytes        *
 * Args: n - Numerator          *
 *       d - Denominator        *
 * Returns: Quotient, Remainder */
char div();
 
/* Maximum of Two Bytes        *
 * Args: b - First Byte        *
 *       c - Second Byte       *
 * Returns: Greater of the Two */
char max();

/* Minimum of Two Bytes       *
 * Args: b - First Byte       *
 *       c - Second Byte      *
 * Returns: Lesser of the Two */
char min();

/* Multiply Unsigned Bytes   *
 * Args: d - Multiplicand    *
 *       r - Multiplier      *
 * Returns: Product LSB, MSB */
char mult();

/* Generate Pseudo-Random Number            *
 * Returns: Random number between 1 and 255 */
char rand();

/* Shift Byte Left                   *
 * Args: b - Byte to Shift           *
 *       n - Number of Bits to Shift *
 * Returns: Shifted Byte             */
char shiftl();

/* Shift Byte Right                  *
 * Args: b - Byte to Shift           *
 *       n - Number of Bits to Shift *
 * Returns: Shifted Byte             */
char shiftr();

/* Seed Pseudo-Random Number Generator *
 * Args: n -  Seed number              */
void srand();