Register parameters
Code Block |
---|
language | none |
---|
title | RST 20H, DEFW $6409$8809 |
---|
|
IN: HLBHL = 0,1,2; not allowed (B=0)
BHL = extended pointer to filename. HL must be > 255
(Bpointer to null-terminated directory path name
out, if successful:
Fc = 0, ->directory HLsuccessfully iscreated
local
pointer)out, if OUT,failed:
if call successful: Fc = 0
OUT1, ifunable callto failed:create directory
Fc = 1 A = error code:
RC_ONF ($12), file not foundIVF, Invalid directory path name
RC_IVF ($17), invalid filenameUSE, Directory in use
RC_USE ($15)EXIS, fileDirectory isalready inexists
use,
ie. not closed registers Registers changed after return:
A..BCDEHL/IXIY same
AF.F....../.... 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)