Difference between revisions of "(File):read"

(Added new 0.11 variant)
Line 1: Line 1:
Read a number of bytes from a file
+
Read a number of bytes from a file.
 
== Function ==
 
== Function ==
 
=== Synopsis ===
 
=== Synopsis ===
Line 6: Line 6:
 
</source>
 
</source>
 
=== Arguments ===
 
=== Arguments ===
{{param|number|bytes (all)|The number of bytes to read}}
+
{{param|number|bytes (all)|The number of bytes to read.}}
 
=== Returns ===
 
=== Returns ===
{{param|string|contents|The contents of the read bytes}}
+
{{param|string|contents|The contents of the read bytes.}}
{{param|number|size|How many bytes have been read}}
+
{{param|number|size|How many bytes have been read.}}
 +
 
 +
== Function ==
 +
{{newin|[[0.11.0]]|110|type=variant}}
 +
Reads the contents of a file into either a string or a [[FileData]] object.
 +
=== Synopsis ===
 +
<source lang="lua">
 +
contents, size = File:read( container, bytes )
 +
</source>
 +
=== Arguments ===
 +
{{param|ContainerType|container|What type to return the file's contents as.}}
 +
{{param|number|bytes (all)|The number of bytes to read.}}
 +
=== Returns ===
 +
{{param|value|contents|[[FileData]] or string containing the read bytes.}}
 +
{{param|number|size|How many bytes have been read.}}
 +
 
 
== See Also ==
 
== See Also ==
 
* [[parent::File]]
 
* [[parent::File]]

Revision as of 00:39, 31 March 2018

Read a number of bytes from a file.

Function

Synopsis

contents, size = File:read( bytes )

Arguments

number bytes (all)
The number of bytes to read.

Returns

string contents
The contents of the read bytes.
number size
How many bytes have been read.

Function

Available since LÖVE 0.11.0
This variant is not supported in earlier versions.

Reads the contents of a file into either a string or a FileData object.

Synopsis

contents, size = File:read( container, bytes )

Arguments

ContainerType container
What type to return the file's contents as.
number bytes (all)
The number of bytes to read.

Returns

value contents
FileData or string containing the read bytes.
number size
How many bytes have been read.

See Also


Other Languages