Texas Instruments TI-89 - Fsetbufsize

572
Appendix A: System Routines — Files
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
FSetBufSize
Declaration:
FSWORD
FSetBufSize
(FILES *
fsPtr
, FSWORD
newBufSize
)
Category(ies):
Files
Description:
Set the buffer size of a file. The buffer size determines how much memory
is reallocated to the file every time a write needs more memory from the
heap. The default size (128 bytes) is set when the file is opened and
should be sufficient for most uses. Setting a larger value will make writes
faster but at the cost of possibly prematurely running out of memory.
Inputs:
fsPtr
— Pointer to FILES structure previously opened with
FOpen
for write mode.
newBufSize
— Size of new buffer.
Outputs:
Returns value stored in
newBufSize
.
Assumptions:
None
Side Effects:
No immediate effect, the buffer size takes effect when the current buffer
becomes full.
Availability:
On AMS 2.00 and higher.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: FOpen, FWrite
Example:
FILE f1;
if (FS_OK == FOpen("APPDATA", &f1, FM_WRITE, "APP1" )) {
FSetBufSize( &f1, 500 ); /* we will be writing a lot of data to this file */
writeLotsOfData( &f1 );
}