fputchar

Tags:

Description

Write one character to a file.

Name Description
handle The File handle to use, earlier opened by fopen().
value The character to write into the file.
utf8 If true, write in UTF8 mode, otherwise in extended ASCII

Returns

This function does not return any specific values.

Examples

// 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\".");
}

Notes

WARNING

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

  • fopen: Open a file.
  • fclose: Close a file.
  • ftemp: Create a temporary file stream.
  • fremove: Remove a file.
  • fwrite: Write to a file.
  • fread: Read a file.
  • fputchar: Put a character in 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.