CP/M/CPM_CDROM.iso/simtel/sigm/vols000/vol089/syslib2.hlp

Text File | 1985-02-10 | 3.9 KB | 88 lines

:Numeric String Evaluation Routines -- EVAL, EVAL16, EVAL10, EVAL8, EVAL2
     Routine Name:  EVAL
     Function║
          Thi≤á routinσ convert≤ thσ characte≥ strinτ pointeΣá t∩ ì
b∙á H╠á int∩ thσ 16-bi⌠ binar∙ numbe≥ representeΣá b∙á it«á  EVA╠ ì
perform≤á thσá conversioεá unti∞ ß non-hexadecima∞á characte≥á i≤ ì
encountered¼ a⌠ whicΦ timσ i⌠ look≤ a⌠ thσ las⌠ characte≥ anΣ thσ ì
previou≤á characte≥ t∩ determinσ iµ thσ strinτ i≤ representinτá ß ì
binary¼á octal¼á decimal¼á o≥ hexadecima∞ number«á  Inpu⌠á strinτ ì
character≤á ma∙ bσ upper- o≥ lower-case«á  ValiΣ format≤ fo≥á thσ ì
inpu⌠ strinτ arσ --
          bbbbbbbbbbbbbbbbB -- b=0 or b=1; Binary string
          ttttt or tttttD -- 0 <= t <= 9; Decimal string
          hhhhH or hhhhX -- 0 <= h <= F; Hexadecimal string
          oooooooO or oooooooQ -- 0 <= o <= 7; Octal string


     Inputs:  HL points to the first byte of the string to convert
              String is loaded in a buffer
     Outputs:  HL points to next character after converted string
               DE contains 16-bit value
               A = E
               CARR┘á Flaτá Se⌠ mean≤ aε erro≥ wa≤á encountereΣá iεá strinτ ì
format
     Registers Affected:  PSW, DE, HL
     SYSLIB Routines Called:  CAPS, EVAL16, EVAL10, EVAL8, EVAL2
     Specia∞á Erro≥ Conditions║
          CARR┘á Flaτ Se⌠ indicate≤ tha⌠ aε erro≥ wa≤ encountereΣ ì
iεá thσá evaluatioεá oµ thσ string╗á iµá so¼á H╠á point≤á t∩á thσ ì
offendinτ character

     Routine Name:  EVAL16
     Function║
          EVAL1╢áá convert≤á thσá strinτá oµá ASCI╔áá hexadecima∞ ì
character≤áá pointeΣá t∩á b∙á H╠á int∩á ßá 16-bi⌠á binar∙á value«  ì
Conversioε progresse≤ unti∞ aε invaliΣ hexadecima∞ digi⌠ (0-9¼ A-ì
F⌐ i≤ encountered.
     Inputs:  HL points to the first byte of the string to convert
              String is loaded in a buffer
     Outputs:  HL points to the offending character
               DE contains the 16-bit value
               A = E
     Registers Affected:  PSW, DE, HL
     SYSLIB Routines Called:  CAPS
     Special Error Conditions:  -None-

     Routine Name:  EVAL10
     Function║
          EVAL1░ convert≤ thσ strinτ oµ ASCI╔ decima∞á character≤ ì
pointeΣá t∩á b∙á H╠á int∩á ßá 16-bi⌠á binar∙á value«á  Conversioε ì
progresse≤ unti∞ aε invaliΣ decima∞ digi⌠ (0-9⌐ i≤ encountered.
     Inputs:  HL points to the first byte of the string to convert
              String is loaded in a buffer
     Outputs:  HL points to the offending character
               DE contains the 16-bit value
               A = E
     Registers Affected:  PSW, DE, HL
     SYSLIB Routines Called:  -None-
     Special Error Conditions:  -None-

     Routine Name:  EVAL8
     Function║
          EVAL╕á convert≤á thσ strinτ oµ ASCI╔á octa∞á character≤ ì
pointeΣá t∩á b∙á H╠á int∩á ßá 16-bi⌠á binar∙á value«á  Conversioε ì
progresse≤ unti∞ aε invaliΣ octa∞ digi⌠ (0-7⌐ i≤ encountered.
     Inputs:  HL points to the first byte of the string to convert
              String is loaded in a buffer
     Outputs:  HL points to the offending character
               DE contains the 16-bit value
               A = E
     Registers Affected:  PSW, DE, HL
     SYSLIB Routines Called:  -None-
     Special Error Conditions:  -None-

     Routine Name:  EVAL2
     Function║
          EVAL▓á convert≤á thσ strinτ oµ ASCI╔ binar∙á character≤ ì
pointeΣá t∩á b∙á H╠á int∩á ßá 16-bi⌠á binar∙á value«á  Conversioε ì
progresse≤ unti∞ aε invaliΣ binar∙ digi⌠ (0-1⌐ i≤ encountered.
     Inputs:  HL points to the first byte of the string to convert
              String is loaded in a buffer
     Outputs:  HL points to the offending character
               DE contains the 16-bit value
               A = E
     Registers Affected:  PSW, DE, HL
     SYSLIB Routines Called:  -None-
     Special Error Conditions:  -None-