Difference between revisions of "love.filesystem.load"

m (Add newin)
m (spelling)
Line 34: Line 34:
 
ok, chunk = pcall( love.filesystem.load, name ) -- load the chunk safely
 
ok, chunk = pcall( love.filesystem.load, name ) -- load the chunk safely
 
if not ok then
 
if not ok then
   print('The following error happend: ' .. tostring(chunk))
+
   print('The following error happened: ' .. tostring(chunk))
 
else
 
else
 
   ok, result = pcall(chunk) -- execute the chunk safely
 
   ok, result = pcall(chunk) -- execute the chunk safely

Revision as of 19:06, 9 May 2020

Available since LÖVE 0.5.0
This function is not supported in earlier versions.

Loads a Lua file (but does not run it).

Function

Synopsis

chunk, errormsg = love.filesystem.load( name )

Arguments

string name
The name (and path) of the file.

Returns

function chunk
The loaded chunk.
string errormsg (nil)
The error message if file could not be opened.

Example

It is important to note that love.filesystem.load does not invoke the code, it just creates a function (a 'chunk') that will contain the contents of the file inside it. In order to execute the chunk, you have to put () behind it.

Also, it is worth noting that loaded files can return values. For example, the following file:

return 1+1

Will return 2, when called like this:

chunk = love.filesystem.load( name ) -- load the chunk
local result = chunk() -- execute the chunk
print('result: ' .. tostring(result)) -- prints 'result: 2'

This bluescreens if there is a syntax error in the loaded file. If you want to continue your game if the file is not valid (for example if you expect it to be written by users), you can protect the calling of the chunk with pcall:

local ok, chunk, result
ok, chunk = pcall( love.filesystem.load, name ) -- load the chunk safely
if not ok then
  print('The following error happened: ' .. tostring(chunk))
else
  ok, result = pcall(chunk) -- execute the chunk safely

  if not ok then -- will be false if there is an error
    print('The following error happened: ' .. tostring(result))
  else
    print('The result of loading is: ' .. tostring(result))
  end
end

See Also


Other Languages