home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / utils / asmutl / mpblib.lbr / MPBLIB.DZC / MPBLIB.DOC
Encoding:
Text File  |  1987-10-26  |  2.5 KB  |  73 lines
  1. NAME:   MPBLIB.REL
  2. DATE:   JUNE 30, 1984
  3.  
  4.      This library module contains five subroutines which are further
  5. described in Z80 Assembly Language Subroutines, by Leventhal & Saville,
  6. Osborne/McGraw-Hill.  These routines are for doing multiple precision
  7. binary arithmetic.  They are:
  8.  
  9. NAME                     PURPOSE
  10.  
  11. MPBADD    Add 2 arrays of binary bytes.
  12.  
  13. MPBSUB    Subtract 2 arrays of binary bytes.
  14.  
  15. MPBMUL    Multiply 2 arrays of binary bytes.
  16.  
  17. MPBDIV    Divide 2 arrays of binary bytes
  18.  
  19. MPBCMP    Compare 2 arrays of binary bytes and return
  20.           with the carry and zero flags set or cleared
  21.           depending upon the relationship of the arrays.
  22.  
  23.  
  24.      These routines are set up for use with the Microsoft assembler and
  25. linking loader.  To call them in a program you must reference the name
  26. as an external and then simply do a call to the subroutine.  For
  27. example,...
  28.  
  29.      EXT  BN2HEX
  30.        *
  31.        *
  32.        *
  33.        *
  34.      CALL BN2HEX
  35.        *
  36.        *
  37.      ETCETERA
  38.  
  39.      To use them with the loader, go:
  40.  
  41. * MPBLIB,YOURPROGRAM,/G
  42.      (Or whichever command line toggle you like)
  43.  
  44.  
  45.      All of these routines have been tested and debugged.  I am making
  46. them available because they aren't available on a disk as far as I know.
  47. To use this stuff you are going to have to buy the man's book.  If you
  48. use these programs commercially then shame on you.  These are for
  49. intellectual exercise only
  50.  
  51.      In order to use these subroutines it is to your advantage to sit
  52. down and code a routine to test run them that you may really grok them
  53. in full.  I suggest that you hunt down a copy of ZPMMAC.MAC which is a
  54. library of Z80 macros adapted from "Mastering CP/M" by Alan Miller.
  55. These macros or similar ones will allow you to do console I/O on any
  56. standard CP/M system... among other things.  Rather than upload all the
  57. subroutines in one gross big file, I am uploading several smaller files.
  58. So far these are:
  59.  
  60. CODELIB.REL              CODE CONVERSION ROUTINES
  61. MPBLIB.REL               MULTI-PRECISION BINARY MATH
  62. MPDLIB.REL               MULTI-PRECISION DECIMAL MATH
  63. ARRAYLIB.REL             ARRAY ROUTINES
  64. BIGLIB.REL               EVERYTHING ELSE IN THE BOOK
  65. STRLIB.REL               STRING HANDLING ROUTINES
  66.  
  67.                                    enjoy,
  68.  
  69.                                    Martin Kilgore
  70.                                    c/o Western States Info
  71.                                    (209) 222-2233
  72.                           (local)  (213) 257-4594
  73.