Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Register parameters

Code Block
titleRST 20H, DEFW $8809
The directory name must not contain wildcards (standard convention).
; However if a RAM device is not specified, it will automatically be included
; (the current) into the directory name.
;
; The buffer of the directory name must have space enough to get itself expanded
; with a device name (additional 6 bytes).
;
; IN:     BHL = pointer to null-terminated directory path name
;
; out, if successful:
;         Fc = 0, directory successfully created
;
;
out, if failed:
;         Fc = 1, unable to create directory
;         A = error code:
;              RC_IVF, Invalid directory path name
;              RC_USE, Directory in use
;              RC_EXIS, Directory already exists
;
;
   registers changed after return:
;         A.BCDEHL/IXIY  same
;         .F....../....  differentIN:
     HL = 0,1,2; not allowed (B=0)
     BHL = extended pointer to filename. HL must be > 255
     (B = 0 -> HL is local pointer)

OUT, if call successful:
     Fc = 0
OUT, if call failed:
     Fc = 1
     A = error code:
          RC_ONF ($12), file not found
          RC_IVF ($17), invalid filename
          RC_USE ($15), file is in use, ie. not closed

Registers changed after return:
     ..BCDEHL/IXIY same
     AF....../.... different 

...

different
 

Notes

  • API call implemented in OZ 5.0
  • Several sub-directories are accepted (eg. :RAM.0/dir1/dir2/dir3 ) up to 205 characters
  • Only accept explicit filenames (wildcard are not allowed)
  • However, if a RAM device is not specified, it will automatically be included (the current) into the directory name.
  • The buffer of the directory name must have space enough to get itself expanded with a device name (additional 6 bytes).
  • The filename must be terminated by a control character, eg. null (0) or CR (13).:EPR.x files are deleted from the filesystem tree and marked as deleted in the filearea.

Related calls

GN_Cl, close file 
GN_Del, delete a file from memory
GN_Opf, open file/resource (wildcard search)
GN_Ren, rename file 
OS_Cl, internal close (OZ usage) 
OS_Del, file delete (internal OZ usage) 
OS_Frm, file read miscellaneous 
OS_Fwm, file write miscellaneous 
OS_Gb, get byte from file (or device) 
OS_Gbt, get byte from file (or device) with timeout 
OS_Mv, move bytes between stream and memory 
OS_Op, internal open (OZ usage) 
OS_Pb, write byte to file, device 
OS_Pbt, write byte to file, device with timeout 
OS_Ren, file rename (internal OZ usage)