FileData

Description:

  Data representing the contents of a file.

type

Type: Function.

Description:

  Gets the type of the object as a string.

Signature:

type: function(self: FileData): string

Returns:

Return Type	Description
string	The type as a string.

Of

Type: Function.

Description:

  Checks whether an object is of a certain type. If the object has the type with the specified name in its hierarchy, this function will return true.

Signature:

typeOf: function(self: FileData, type_name: string): boolean

Parameters:

Parameter	Type	Description
type_name	string	The name of the type to check for.

Returns:

Return Type	Description
boolean	True if the object is of the specified type, false otherwise.

release

Type: Function.

Description:

  Destroys the object's Lua reference. The object will be completely deleted if it's not referenced by any other LÖVE object or thread. This method can be used to immediately clean up resources without waiting for Lua's garbage collector.

Signature:

release: function(self: FileData): boolean

Returns:

Return Type	Description
boolean	True if the object was released by this call, false if it had been previously released.

getString

Type: Function.

Description:

  Gets the full Data as a string.

Signature:

getString: function(self: FileData): string

Returns:

Return Type	Description
string	The raw data.

getSize

Type: Function.

Description:

  Gets the Data's size in bytes.

Signature:

getSize: function(self: FileData): integer

Returns:

Return Type	Description
integer	The size of the Data in bytes.

getPointer

Type: Function.

Description:

  Gets a pointer to the Data. Can be used with libraries such as LuaJIT's FFI.

Signature:

getPointer: function(self: FileData): any

Returns:

Return Type	Description
any	A raw pointer to the Data.

getFFIPointer

Type: Function.

Description:

  Gets an FFI pointer to the Data. This function should be preferred instead of Data:getPointer because the latter uses light userdata which can't store more all possible memory addresses on some new ARM64 architectures, when LuaJIT is used.

Signature:

getFFIPointer: function(self: FileData): nil

Returns:

Return Type	Description
nil	A raw void* pointer to the Data, or nil if FFI is unavailable.

clone

Type: Function.

Description:

  Creates a new copy of the Data object.

Signature:

clone: function(self: FileData): FileData

Returns:

Return Type	Description
FileData	The new copy.

getFilename

Type: Function.

Description:

  Gets the filename of the FileData.

Signature:

getFilename: function(self: FileData): string

Returns:

Return Type	Description
string	The name of the file the FileData represents.

getExtension

Type: Function.

Description:

  Gets the extension of the FileData.

Signature:

getExtension: function(self: FileData): string

Returns:

Return Type	Description
string	The extension of the file the FileData represents.