File_WriteByte()

Syntax

File_WriteByte(pBytein)

Overview

pBytein: The byte you want to write to the file.

Write a Single Byte to an Open File

The File_WriteByte() procedure writes a single byte to an open file. To write to the n-th byte of the file, you need to call this function in a loop and first read up to the n-1-th byte with File_ReadByte().

How it works

• File Open Check: Before writing to a file, you must open it using File_Open(), File_Append(), or File_OpenAt().
  Opens the file and positions the pointer at the end for appending new data.
• Disk Full Check: You can monitor the Disk_tIsFull variable to detect when the SD card's storage is full.
  When Disk_tIsFull = 1, the memory is full, and no more data can be written to the SD card.
• File Open Check: Before writing to a file, you need to check if a file is currently open.
  This can be done by monitoring the File_tIsOpen variable, where File_tIsOpen = 1 indicates the file is open and available for writing.
• End of File (EOF): The File_tEOF variable helps track whether you have reached the end of the file.
  If File_tEOF = 1, it indicates you've reached the end of the file. This is important because if you're writing data after the last byte, you'll need to append or overwrite based on the file's current position.

Example

File_WriteByte("A")

Notes

• If you're writing to the n-th byte, you need to read the previous bytes first. You can loop through and use File_ReadByte() to read up to the n-2-th byte, then call File_WriteByte() for the byte you want to write.
• Ensure you check for a Disk_tIsFull condition before writing to avoid writing past the available storage space.
• Once a file is open and data is written, it remains open until closed using File_Close().

Created with the Personal Edition of HelpNDoc: Free iPhone documentation generator