Flength

From SA-MP Wiki

Jump to: navigation, search

flength

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


Description:

Returns the length of a file.


Parameters:
(File:handle)
handleThe file handle returned by fopen or ftemp


Return Values:

The length of a file, in bytes.


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 "read only" mode
new File:handle = fopen("file.txt", io_read);
 
// If "file.txt" is open
if(handle)
{
	// Success
 
	// Print the size oin bytes of "file.txt"
	printf("File size: %d", flength(handle));
 
	// 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.
  • fgetchar: Get a character 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.
Personal tools