FileRead

From Multi Theft Auto: Wiki
Revision as of 13:26, 2 August 2024 by Tracer (talk | contribs) (Undo revision 79715 - Feature reintroduced)
Jump to navigation Jump to search

Reads the specified number of bytes from the given file starting at its current read/write position, and returns them as a string.

Syntax

string fileRead ( file theFile, int count )
BETA: NEW FEATURE (BUILD: 1.6.0 r22650)
string fileRead ( string filePath )

OOP Syntax Help! I don't understand this!

Method: file:read(...)


Required Arguments

  • theFile: A handle to the file you wish to read from. Use fileOpen to obtain this handle.
  • count: The number of bytes you wish to read.
BETA: NEW FEATURE (BUILD: 1.6.0 r22650)
  • filePath: Path to the file you want to read

Returns

Returns the bytes that were read in a string. Note that this string might not contain as many bytes as you specified if an error occured, i.e. end of file.

Example

Click to collapse [-]
Shared

This example opens the file test.txt and outputs its contents to the console.

function readFile(path)
    local file = fileOpen(path) -- attempt to open the file
    if not file then
        return false -- stop function on failure
    end
    local count = fileGetSize(file) -- get file's total size
    local data = fileRead(file, count) -- read whole file
    fileClose(file) -- close the file once we're done with it
    outputConsole(data) -- output code in console
end

addCommandHandler("readfile",function(cmd,fileName) -- add command to test this function
    readFile(fileName) -- execute the function
end)
Click to collapse [-]
Server

This example reads file from path and prints its content to the console

addCommandHandler('readFile', function(player, cmd, file)
    if not file then
        outputChatBox('You need to provide a path!', player, 255,0,0)
        return
    end
    outputChatBox(fileRead(file), player)
end)

See Also