83Plus:Software:usb8x/Asm Interface/MSD/DOS createFile - Revision history

Dr. D'nar at 00:17, 20 October 2008

2008-10-20T00:17:08Z

Dr. D'nar: Brandon forgot he used the OP registers. . .

2008-10-20T00:11:13Z

Brandon forgot he used the OP registers. . .

Brandonw at 17:03, 17 August 2006

2006-08-17T17:03:53Z

Brandonw at 09:14, 17 August 2006

2006-08-17T09:14:31Z

New page

== 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

== Notes ==
The file created date/time attributes are set according to the 84+/SE clock.
Example code to create "readme.txt" in "test" directory:
<code>
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
</code>

== See Also ==
* [[../FAT_getStartingCluster|FAT_getStartingCluster]] - Get starting cluster of specified directory

@@ Line 33: / Line 33: @@
 </code>
 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

@@ Line 16: / Line 16: @@
 === Destroys ===
 * AF, BC, DE, HL
 == Notes ==