Fputchar

From SA-MP Wiki

Jump to: navigation, search

fputchar

Image:Farm-Fresh text lowercase.png Note: This function name starts with a lowercase letter.


Description:

Write one character to a file.


Parameters:
(File: handle, value, bool: utf8 = true)
handleThe File handle to use, earlier opened by fopen().
valueThe character to write into the file.
utf8If true, write in UTF8 mode, otherwise in extended ASCII


Return Values:

This function does not return any specific values.


Image:32px-Circle-style-warning.png

Warning

Using an invalid handle will crash your server! Get a valid handle by using fopen or ftemp.


Example Usage:

// Open "file.txt" in "write only" mode
new File:handle = fopen("file.txt", io_write);
if(handle)
{
	// Success
 
	// Write character "e" into "file.txt"
	fputchar(handle, 'e', false);
 
	// Close "file.txt"
	fclose(handle);
}
else
{
	// Error
	print("Failed to open \"file.txt\".");
}

Related Functions

The following functions may be useful, as they are related to this function in one way or another.


  • ftemp: Create a temporary file stream.
  • fputchar: Put a character in a file.
  • fgetchar: Get a character from a file.
  • fseek: Jump to a specific character in a file.
  • fexist: Check, if a file exists.
  • fmatch: Check, if patterns with a file name matches.
Personal tools