home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / y.lbr / ZSLIB5.HZP / ZSLIB5.HLP
Encoding:
Text File  |  1991-09-14  |  5.4 KB  |  129 lines
  1.  Console String Input Editor                 - TLINE
  2.  Print Character with Tab Expansion          - TCOUT, TCOUT7
  3.  Print High Bit- or Null-Terminated String   - HPRINT, HPSTR
  4.  Print with Highlighted Video                - HVPRINT, HVPSTR
  5.  Begin or End Highlighted Video              - HVON, HVOFF
  6.  Initialize or De-initialize Terminal        - HVTINIT, HVDINIT
  7.  Output Counted String on Printer            - LCSTR
  8.  Store Character or String to Memory         - MOUT, MSTR
  9. :
  10. TLINE - Tiny in-line editor for console input.
  11.  
  12.   ENTER: HL = address of buffer (length=number of characters allowed + 1),
  13.          B = number of characters allowed (255 maximum),
  14.          A = echo flag (0=echo input, FFh=echo dots).
  15.   EXIT:  A = 0, zero flag set (Z), if null-terminated string is in buffer,
  16.          A = 3, zero flag reset (NZ), if user aborted with control-C (^C).
  17.   USES:  AF
  18.  
  19. Usage: Only backspace and delete are available for editing input line.  A 
  20. carriage return ends input and a null is inserted at end of line.  A ^C 
  21. aborts the editor (string is not terminated).  Other control characters are 
  22. rejected and the console bell is sounded.  The bell is also sounded if the 
  23. user attempts to backspace beyond the beginning of the line or to input 
  24. more characters than allowed.
  25. :
  26. TCOUT, TCOUT7 - Prints character on console, expanding tabs.
  27.  
  28.   ENTER: A = character.
  29.   EXIT:  None (but TCOUT7 resets high bit of character).
  30.   USES:  None (but TCOUT7 uses AF).
  31.  
  32. Usage: If tab expansion is to be used, the first call to these routines 
  33. should have a carriage return (0Dh) in A to reset the column counter.  Only 
  34. printable characters are counted.  TCOUT7 zeros all high bits.  These 
  35. routines are primarily intended for printing strings from within loops.
  36. :
  37. HPRINT - Prints in-line string terminated with high-bit or null character.
  38.  
  39.   ENTER: Stack points to string terminated by a null or by a character with
  40.            its high bit set.
  41.   EXIT:  None (execution resumes at byte following terminating character).
  42.   USES:  None.
  43.  
  44. HPSTR - Prints addressed string terminated with high-bit or null character.
  45.  
  46.   ENTER: HL = address of string terminated by a null or by a character with
  47.            its high bit set.
  48.   EXIT:  HL = address of byte following terminating character.
  49.   USES:  HL
  50.  
  51. Usage: Tabs are expanded; other control characters are passed unaffected.
  52. :
  53. HVPRINT - Prints in-line string terminated high-bit or null character, with 
  54.      highlighting.
  55.  
  56.   ENTER: Stack points to string terminated by a null or by a character with 
  57.            its high bit set.
  58.   EXIT:  None (execution resumes at byte following terminating character).
  59.   USES:  None.
  60.  
  61. HVPSTR - Prints addressed string terminated with high-bit or null character,
  62.      with highlighting.
  63.  
  64.   ENTER: HL = address of string terminated by a null or by a character with 
  65.            its high bit set.
  66.   EXIT:  HL = address of byte following terminating character.
  67.   USES:  HL
  68.  
  69. Usage: Z3INIT from Z3LIB must be called before using these routines.  Tabs 
  70. are expanded, ^A marks the beginning of highlighted video, and ^B marks the 
  71. end of highlighted video.  Other control characters are passed unaffected, 
  72. but do not count toward tab expansion.  There is no size advantage if any 
  73. VLIB routines are used.  See HVON and HVOFF for more information.
  74. :
  75. HVON, HVOFF - Turns video highlighting on and off.
  76.  
  77.   ENTER: None.
  78.   EXIT:  None.
  79.   USES:  None.
  80.  
  81. Usage: Z3INIT from Z3LIB must be called before using these routines.  HVON 
  82. turns on highlighting; HVOFF turns off highlighting.  If there is no 
  83. environment, no TCAP, or no standout strings, nothing is done.  If all you 
  84. need is simple highlighting, these routines are much smaller than similar 
  85. routines in VLIB 4.  There is no size advantage, however, if any VLIB 
  86. routines are called by your program.  Your program should also call HVTINIT 
  87. on entry and HVDINIT before exiting.
  88. :
  89. HVTINIT, HVDINIT - Initializes and de-initializes terminal.
  90.  
  91.   ENTER: None.
  92.   EXIT:  None.
  93.   USES:  None.
  94.  
  95. Usage: Z3INIT from Z3LIB must be called before using these routines.  
  96. HVTINIT initializes terminal; HVDINIT de-initializes terminal.  If there is 
  97. no environment, no TCAP, or no initialization and de-initialization 
  98. strings, nothing is done.  HVTINIT should be called early in your program 
  99. before any calls to HVON, HVOFF, HVPRINT, or HVPSTR.  HVDINIT should be 
  100. called before your program exits.
  101. :
  102. LCSTR - Outputs counted string to printer.
  103.  
  104.   ENTER: HL = address of character count (first byte) of string.
  105.   EXIT:  None.
  106.   USES:  None.
  107.  
  108. Usage: String requires no termination character, but the first byte is the 
  109. length of the string that immediately follows.  Characters are sent as-is 
  110. with no interpretation.
  111. :
  112. MOUT - Stores character to memory.
  113.  
  114.   ENTER: A = character,
  115.          DE = address of memory buffer (1 byte).
  116.   EXIT:  DE = address of byte after output.
  117.   USES:  DE
  118.  
  119. MSTR - Stores null-terminated string to memory.
  120.  
  121.   ENTER: HL = address of null-terminated string,
  122.          DE = address of memory buffer for output.
  123.   EXIT:  HL = address of byte following the terminating null,
  124.          DE = address of byte after output.
  125.   USES:  DE, HL
  126.  
  127. Usage: These routines can be called repeatedly to write characters and 
  128. strings to successive addresses in memory.
  129.