home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / CPM / ZCPR33 / S-Z / V4LIBHLP.LBR / SYSLIB9.HZP / SYSLIB9.HLP
Text File  |  1989-05-01  |  2KB  |  56 lines
  1.  File Name String Parser  - FNAME
  2.  FCB Initialization       - INITFCB
  3. :FNAME - File Name String Parser
  4.  
  5.   ENTER: HL = Pointer to target string ending with delimiter
  6.      DE = Pointer to a 36-byte long FCB
  7.   EXIT : BC = Disk/User
  8.           B=Disk (Drive A=1..P=16, 0FFH=No Disk specified)
  9.           C=User (0..31, '?'=All Users, 0FFH=No User spec)
  10.      HL = Pointer to the character which ended the scan
  11.       A <> 0, Zero Flag Clear (NZ) if String Parsed Ok
  12.           A = 0, Zero Set (Z) if invalid Disk or User
  13.   USES : AF,BC,HL
  14.  
  15.  Usage:  This routine parses a string to a specified FCB, and
  16.   Disk/User to Registers.  The string is assumed to be in form:
  17.  
  18.         DU:FILENAME.TYP
  19.  
  20.   where any part of the specification is optional.  It clears
  21.   all bytes of the FCB to Zero except for the FN (File Name)
  22.   and FT (File Type) fields which are initialized to values
  23.   extracted from the string, or Spaces if absent.
  24.  
  25.   The string pointed to by HL is not a conventional string in
  26.   the sense of the rest of the SYSLIB routines.  It is ended
  27.   by any of the following delimiters, as opposed by simply
  28.   always being terminated by a binary zero.  Delimiters are:
  29.  
  30.     <NULL or Binary 0>    <SP or Space>
  31.          =    _    ;    ,    <    >
  32.  
  33.  Examples:
  34.  
  35.     TEST.TXT    <-- FN=TEXT  FT=TXT, B = 0FFH, C = 0FFH
  36.  
  37.     A:T        <-- FN=T  FT=<Saces>, B = 1, C = 0FFH
  38.  
  39.     5:T        <-- FN=T  FT=<Saces>, B = 0FFH, C = 5
  40.  
  41.     C10:X.Y        <-- FN=X  FT=Y, B = 3, C = 10
  42.  
  43. :INITFCB - FCB Initialization
  44.  
  45.   ENTER: DE = Pointer to 36-byte FCB buffer
  46.   EXIT : None
  47.   USES : None
  48.  
  49.  Usage:  This routine is used as a general purpose application
  50.   to clear all bytes in an FCB to Zero except for the File Name
  51.   and Type fields.
  52.  
  53.   Note: Using INITFCB to prepare FCBs for use destroys any
  54.   Drive specification in the first byte of the FCB since it
  55.   will be set to Zero equating to the Currently Logged Drive.
  56.