home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / utils / asmutl / biglib.lbr / BIGLIB.DZC / BIGLIB.DOC
Encoding:
Text File  |  1987-10-26  |  3.1 KB  |  98 lines
  1. NAME:   BIGLIB.REL
  2. DATE:   JULY 21, 1984
  3.  
  4.      This library module contains four subroutines which are further
  5. described in Z80 Assembly Language Subroutines, by Leventhal & Saville,
  6. Osborne/McGraw-Hill.  These routines are for doing String manipulation.
  7. They are:
  8.  
  9. NAME                     PURPOSE
  10.  
  11. MFILL     Fills an area in memory with a character.
  12.  
  13. MUL16     16 bit multiplication.
  14.  
  15. SDIV16    Signed 16 bit division
  16.  
  17. UDIV16    Unsigned 16 bit division
  18.  
  19. CMP16     16 bit comparison
  20.  
  21. BFE       Bit field extraction
  22.  
  23. BFI       bit field insertion
  24.  
  25. MPASR     multiple precision arithmetic shift right
  26.  
  27. MPLSL     multiple precision logical shift left
  28.  
  29. MPLSR     multiple precision logical shift right
  30.  
  31. MPRR      multiple precision rotate right
  32.  
  33. MPRL      multiple precision rotate left
  34.  
  35. ASUM8     8 bit array summation
  36.  
  37. ASUM16    16 bit array summation
  38.  
  39. MAXELM    find the maximum byte length element in an array
  40.  
  41. MINELM    find the minimum byte length element in an array
  42.  
  43. BINSCH    binary search of a sorted array
  44.  
  45. QSORT     quick sort of a 16 bit array
  46.  
  47. JTAB      jump table..this routine expects to find LENSUB
  48.           and JMPTAB defined as public in the calling program.
  49.  
  50.      These routines are set up for use with the Microsoft assembler and
  51. linking loader.  To call them in a program you must reference the name
  52. as an external and then simply do a call to the subroutine.  For
  53. example,...
  54.  
  55.      EXT  BN2HEX
  56.        *
  57.        *
  58.        *
  59.        *
  60.      CALL BN2HEX
  61.        *
  62.        *
  63.      ETCETERA
  64.  
  65.      To use them with the loader, go:
  66.  
  67. * MPDLIB,YOURPROGRAM,/G
  68.      (Or whichever command line toggle you like)
  69.  
  70.      All of these routines have been tested and debugged.  I am making
  71. them available because they aren't available on a disk as far as I know.
  72. To use this stuff you are going to have to buy the man's book.  If you
  73. use these programs commercially then shame on you.  These are for
  74. intellectual exercise only
  75.  
  76.      In order to use these subroutines it is to your advantage to sit
  77. down and code a routine to test run them that you may really grok them
  78. in full.  I suggest that you hunt down a copy of ZPMMAC.MAC which is a
  79. library of Z80 macros adapted from "Mastering CP/M" by Alan Miller.
  80. These macros or similar ones will alllow you to do console I/O on any
  81. standard CP/M system... among other things.  Rather than upload all the
  82. subroutines in one gross big file, I am uploading several smaller files.
  83. So far these are:
  84.  
  85. CODELIB.REL              CODE CONVERSION ROUTINES
  86. MPBLIB.REL               MULTI-PRECISION BINARY MATH
  87. MPDLIB.REL               MULTI-PRECISION DECIMAL MATH
  88. ARRAYLIB.REL             ARRAY ROUTINES
  89. BIGLIB.REL               EVERYTHING ELSE IN THE BOOK
  90. STRLIB.REL               STRING HANDLING LIBRARY
  91.  
  92.                                    enjoy,
  93.  
  94.                                    Martin Kilgore
  95.                                    c/o Western States Info
  96.                                    (209) 222-2233
  97.                           (local)  (213) 257-4594
  98.