Fputchar

fputchar

Description:

Function fputchar write one character to a file.

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

This function name starts with a lowercase letter.

Parameters:

(File: handle, value, bool: utf8 = true)

int

handle

The File handle to use, earlier opened by fopen().

int

value

The character to write into the file.

bool

utf8

If true, write in UTF8 mode, otherwise in extended ASCII

Return Values:

This function does not return any specific values.

Examples:

Example 1

// 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.

• fopen: Open a file (to read from or write to).
• fclose: Close a file.
• ftemp: Create a temporary file stream.
• fremove: Remove a file.
• fwrite: Write to a file.
• fread: Read a file.
• fgetchar: Get a character from a file.
• fblockwrite: Write blocks of data into a file.
• fblockread: Read blocks of data from a file.
• fseek: Jump to a specific character in a file.
• flength: Get the file length.
• fexist: Check, if a file exists.
• fmatch: Check, if patterns with a file name matches.