org.luaj.vm2.lib.jse
Class JseOsLib

java.lang.Object
  org.luaj.vm2.Varargs
      org.luaj.vm2.LuaValue
          org.luaj.vm2.LuaFunction
              org.luaj.vm2.lib.LibFunction
                  org.luaj.vm2.lib.VarArgFunction
                      org.luaj.vm2.lib.OsLib
                          org.luaj.vm2.lib.jse.JseOsLib

public class JseOsLib
extends OsLib

Subclass of LibFunction which implements the standard lua os library.

This contains more complete implementations of the following functions using features that are specific to JSE:

• execute()
• remove()
• rename()
• tmpname()

Because the nature of the os library is to encapsulate os-specific features, the behavior of these functions varies considerably from their counterparts in the C platform.

Typically, this library is included as part of a call to either JsePlatform.standardGlobals()

To instantiate and use it directly, link it into your globals table via LuaValue.load(LuaValue) using code such as:

 LuaTable _G = new LuaTable();
 LuaThread.setGlobals(_G);
 _G.load(new JseBaseLib());
 _G.load(new PackageLib());
 _G.load(new JseOsLib());
 System.out.println( _G.get("os").get("time").call() );
  

Doing so will ensure the library is properly initialized and loaded into the globals table.

See Also:

LibFunction, OsLib, JsePlatform, JmePlatform, http://www.lua.org/manual/5.1/manual.html#5.8

Field Summary

static int	EXEC_ERROR return code indicating the execute() threw an unknown exception
static int	EXEC_INTERRUPTED return code indicating the execute() was interrupted
static int	EXEC_IOEXCEPTION return code indicating the execute() threw an I/O exception

Fields inherited from class org.luaj.vm2.lib.OsLib

TMP_PREFIX, TMP_SUFFIX

Fields inherited from class org.luaj.vm2.lib.LibFunction

name, opcode

Fields inherited from class org.luaj.vm2.LuaFunction

env, s_metatable

Fields inherited from class org.luaj.vm2.LuaValue

ADD, CALL, CONCAT, DIV, EMPTYSTRING, EQ, FALSE, INDEX, LE, LEN, LT, METATABLE, MINUSONE, MOD, MODE, MUL, NEWINDEX, NIL, NILS, NONE, NOVALS, ONE, POW, SUB, TBOOLEAN, TFUNCTION, TINT, TLIGHTUSERDATA, TNIL, TNONE, TNUMBER, TOSTRING, TRUE, TSTRING, TTABLE, TTHREAD, TUSERDATA, TVALUE, TYPE_NAMES, UNM, ZERO

Constructor Summary

JseOsLib()
public constructor

Method Summary

protected int	execute(java.lang.String command) This function is equivalent to the C function system.
protected void	remove(java.lang.String filename) Deletes the file or directory with the given name.
protected void	rename(java.lang.String oldname, java.lang.String newname) Renames file or directory named oldname to newname.
protected java.lang.String	tmpname() Returns a string with a file name that can be used for a temporary file.

Methods inherited from class org.luaj.vm2.lib.OsLib

clock, date, difftime, exit, getenv, init, invoke, setlocale, time

Methods inherited from class org.luaj.vm2.lib.VarArgFunction

call, call, call, call, onInvoke

Methods inherited from class org.luaj.vm2.lib.LibFunction

bind, bind, newupe, newupl, newupn, tojstring

Methods inherited from class org.luaj.vm2.LuaFunction

checkfunction, getfenv, getmetatable, isfunction, optfunction, setfenv, type, typename

Methods inherited from class org.luaj.vm2.LuaValue

add, add, add, and, arg, arg1, argerror, argerror, aritherror, aritherror, arithmt, arithmtwith, assert_, buffer, callmt, checkboolean, checkclosure, checkdouble, checkint, checkinteger, checkjstring, checklong, checkmetatag, checknotnil, checknumber, checknumber, checkstring, checktable, checkthread, checkuserdata, checkuserdata, checkvalidkey, compareerror, compareerror, comparemt, concat, concat, concatmt, concatTo, concatTo, concatTo, div, div, div, divInto, eq_b, eq, eqmtcall, equals, error, get, get, get, getn, gettable, gt_b, gt_b, gt_b, gt, gt, gt, gteq_b, gteq_b, gteq_b, gteq, gteq, gteq, illegal, inext, invoke, invoke, invoke, invoke, invoke, invokemethod, invokemethod, invokemethod, invokemethod, invokemethod, invokemethod, isboolean, isclosure, isint, isinttype, islong, isnil, isnumber, isstring, istable, isthread, isuserdata, isuserdata, isweaknil, len, lenerror, length, listOf, listOf, load, lt_b, lt_b, lt_b, lt, lt, lt, lteq_b, lteq_b, lteq_b, lteq, lteq, lteq, metatag, method, method, method, method, method, method, mod, mod, mod, modFrom, mul, mul, mul, narg, neg, neq_b, neq, next, not, optboolean, optclosure, optdouble, optint, optinteger, optjstring, optlong, optnumber, optstring, opttable, optthread, optuserdata, optuserdata, optvalue, or, pow, pow, pow, powWith, powWith, presize, raweq, raweq, raweq, raweq, raweq, rawget, rawget, rawget, rawset, rawset, rawset, rawset, rawset, rawset, rawset, rawsetlist, set, set, set, set, set, set, set, setmetatable, settable, strcmp, strcmp, strongkey, strongvalue, strvalue, sub, sub, sub, subFrom, subFrom, tableOf, tableOf, tableOf, tableOf, tableOf, tableOf, tailcallOf, testfor_b, toboolean, tobyte, tochar, todouble, tofloat, toint, tolong, tonumber, toshort, tostring, toString, touserdata, touserdata, typerror, unimplemented, userdataOf, userdataOf, valueOf, valueOf, valueOf, valueOf, valueOf, valueOf, varargsOf, varargsOf, varargsOf, varargsOf, varargsOf, varargsOf

Methods inherited from class org.luaj.vm2.Varargs

argcheck, checkboolean, checkclosure, checkdouble, checkfunction, checkint, checkinteger, checkjstring, checklong, checknotnil, checknumber, checkstring, checktable, checkthread, checkuserdata, checkuserdata, checkvalue, eval, isfunction, isnil, isnoneornil, isnumber, isstring, istable, isTailcall, isthread, isuserdata, isvalue, optboolean, optclosure, optdouble, optfunction, optint, optinteger, optjstring, optlong, optnumber, optstring, opttable, optthread, optuserdata, optuserdata, optvalue, subargs, toboolean, tobyte, tochar, todouble, tofloat, toint, tojstring, tolong, toshort, touserdata, touserdata, type

Methods inherited from class java.lang.Object

clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

EXEC_IOEXCEPTION

public static int EXEC_IOEXCEPTION

return code indicating the execute() threw an I/O exception

EXEC_INTERRUPTED

public static int EXEC_INTERRUPTED

return code indicating the execute() was interrupted

EXEC_ERROR

public static int EXEC_ERROR

return code indicating the execute() threw an unknown exception

Constructor Detail

JseOsLib

public JseOsLib()

public constructor

Method Detail

execute

protected int execute(java.lang.String command)

Description copied from class: OsLib

This function is equivalent to the C function system. It passes command to be executed by an operating system shell. It returns a status code, which is system-dependent. If command is absent, then it returns nonzero if a shell is available and zero otherwise.

Overrides:

execute in class OsLib

Parameters:

command - command to pass to the system

remove

protected void remove(java.lang.String filename)
               throws java.io.IOException

Description copied from class: OsLib

Deletes the file or directory with the given name. Directories must be empty to be removed. If this function fails, it throws and IOException

Overrides:

remove in class OsLib

Throws:

java.io.IOException - if it fails

rename

protected void rename(java.lang.String oldname,
                      java.lang.String newname)
               throws java.io.IOException

Description copied from class: OsLib

Renames file or directory named oldname to newname. If this function fails,it throws and IOException

Overrides:

rename in class OsLib

Parameters:

oldname - old file name

newname - new file name

Throws:

java.io.IOException - if it fails

tmpname

protected java.lang.String tmpname()

Description copied from class: OsLib

Returns a string with a file name that can be used for a temporary file. The file must be explicitly opened before its use and explicitly removed when no longer needed. On some systems (POSIX), this function also creates a file with that name, to avoid security risks. (Someone else might create the file with wrong permissions in the time between getting the name and creating the file.) You still have to open the file to use it and to remove it (even if you do not use it).

Overrides:

tmpname in class OsLib

Returns:

String filename to use