Difference between revisions of "83Plus:Software:usb8x/Asm Interface/MSD/DOS createFile"
From WikiTI
		
		
		
m  | 
				 (Brandon forgot he used the OP registers. . .)  | 
				||
| Line 16: | Line 16: | ||
=== Destroys ===  | === Destroys ===  | ||
* AF, BC, DE, HL  | * AF, BC, DE, HL  | ||
| + | * OP registers  | ||
== Notes ==  | == Notes ==  | ||
Revision as of 16:11, 19 October 2008
Synopsis
Name: DOS_createFile
Minimum usb8x version: 0.10
Creates a new file in specified directory of size 0.
Inputs
- BC points to the starting cluster of the directory to create file in (obtained with [[../FAT_getStartingCluster|FAT_getStartingCluster]])
 - HL points to an ASCIIZ string of the filename (ex. "test.txt")
 
Outputs
- File is created with size 0
 - C set if problems
 
Destroys
- AF, BC, DE, HL
 - OP registers
 
Notes
The file created date/time attributes are set according to the 84+/SE clock.
Example code to create "readme.txt" in "test" directory:
ld hl,sDirectory U_CALL FAT_getStartingCluster push hl pop bc ;BC contains starting cluster ld hl,sFilename U_CALL DOS_createFile ... sFilename: DB "readme.txt",0 sDirectory: DB "/test",0
To read/write to this file, you must then open the file with [[../DOS_openFile|DOS_openFile]].
See Also
- [[../FAT_getStartingCluster|FAT_getStartingCluster]] - Get starting cluster of specified directory
 - [[../DOS_openFile|DOS_openFile]] - Open file for reading and writing