org.luaj.vm2.lib

类 IoLib

java.lang.Object

org.luaj.vm2.Varargs

org.luaj.vm2.LuaValue

org.luaj.vm2.LuaFunction

org.luaj.vm2.lib.LibFunction

org.luaj.vm2.lib.TwoArgFunction

org.luaj.vm2.lib.IoLib

直接已知子类:

JseIoLib

public abstract class IoLib
extends TwoArgFunction

Abstract base class extending LibFunction which implements the core of the lua standard io library.

It contains the implementation of the io library support that is common to the JSE and JME platforms. In practice on of the concrete IOLib subclasses is chosen: JseIoLib for the JSE platform, and org.luaj.vm2.lib.jme.JmeIoLib for the JME platform.

The JSE implementation conforms almost completely to the C-based lua library, while the JME implementation follows closely except in the area of random-access files, which are difficult to support properly on JME.

Typically, this library is included as part of a call to either JsePlatform.standardGlobals() or org.luaj.vm2.lib.jme.JmePlatform#standardGlobals()

 
 Globals globals = JsePlatform.standardGlobals();
 globals.get("io").get("write").call(LuaValue.valueOf("hello, world\n"));
  

In this example the platform-specific JseIoLib library will be loaded, which will include the base functionality provided by this class, whereas the JsePlatform would load the JseIoLib.

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

 
 Globals globals = new Globals();
 globals.load(new JseBaseLib());
 globals.load(new PackageLib());
 globals.load(new OsLib());
 globals.get("io").get("write").call(LuaValue.valueOf("hello, world\n"));
  

This has been implemented to match as closely as possible the behavior in the corresponding library in C.

另请参阅:

LibFunction, JsePlatform, org.luaj.vm2.lib.jme.JmePlatform, JseIoLib, org.luaj.vm2.lib.jme.JmeIoLib, http://www.lua.org/manual/5.1/manual.html#5.7

嵌套类概要

嵌套类

限定符和类型	类和说明
protected class	IoLib.File

字段概要

字段

限定符和类型	字段和说明
static String[]	FILE_NAMES
protected static int	FTYPE_NAMED Enumerated value representing a file type for a named file
protected static int	FTYPE_STDERR Enumerated value representing stderr
protected static int	FTYPE_STDIN Enumerated value representing stdin
protected static int	FTYPE_STDOUT Enumerated value representing stdout
protected Globals	globals
static String[]	IO_NAMES

从类继承的字段 org.luaj.vm2.lib.LibFunction

name, opcode

从类继承的字段 org.luaj.vm2.LuaFunction

s_metatable

从类继承的字段 org.luaj.vm2.LuaValue

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

构造器概要

构造器

构造器和说明
IoLib()

方法概要

限定符和类型	方法和说明
Varargs	_file_close(LuaValue file)
Varargs	_file_flush(LuaValue file)
Varargs	_file_lines(Varargs args)
Varargs	_file_read(LuaValue file, Varargs subargs)
Varargs	_file_seek(LuaValue file, String whence, int offset)
Varargs	_file_setvbuf(LuaValue file, String mode, int size)
Varargs	_file_write(LuaValue file, Varargs subargs)
Varargs	_io_close(LuaValue file)
Varargs	_io_flush()
Varargs	_io_index(LuaValue v)
Varargs	_io_input(LuaValue file)
Varargs	_io_lines(Varargs args)
Varargs	_io_open(String filename, String mode)
Varargs	_io_output(LuaValue filename)
Varargs	_io_popen(String prog, String mode)
Varargs	_io_read(Varargs args)
Varargs	_io_tmpfile()
Varargs	_io_type(LuaValue obj)
Varargs	_io_write(Varargs args)
Varargs	_lines_iter(LuaValue file, boolean toclose, Varargs args)
LuaValue	call(LuaValue modname, LuaValue env) Call this with 2 arguments, including metatag processing, and return only the first return value.
static LuaValue	freadall(IoLib.File f)
static LuaValue	freadbytes(IoLib.File f, int count)
static LuaValue	freadline(IoLib.File f, boolean withend)
static LuaValue	freadnumber(IoLib.File f)
static LuaValue	freaduntil(IoLib.File f, boolean lineonly, boolean withend)
protected abstract IoLib.File	openFile(String filename, boolean readMode, boolean appendMode, boolean updateMode, boolean binaryMode) Open a file in a particular mode.
protected abstract IoLib.File	openProgram(String prog, String mode) Start a new process and return a file for input or output
protected abstract IoLib.File	tmpFile() Open a temporary file.
protected abstract IoLib.File	wrapStderr() Wrap the standard error output.
protected abstract IoLib.File	wrapStdin() Wrap the standard input.
protected abstract IoLib.File	wrapStdout() Wrap the standard output.

从类继承的方法 org.luaj.vm2.lib.TwoArgFunction

call, call, call, invoke

从类继承的方法 org.luaj.vm2.lib.LibFunction

bind, bind, call, newupe, newupl, newupn, tojstring

从类继承的方法 org.luaj.vm2.LuaFunction

checkfunction, classnamestub, getfenv, getmetatable, isfunction, name, optfunction, setfenv, strvalue, type, typename

从类继承的方法 org.luaj.vm2.LuaValue

add, add, add, and, arg, arg1, argerror, argerror, aritherror, aritherror, arithmt, arithmtwith, assert_, band, band, bnot, bor, bor, buffer, bxor, bxor, call, callmt, checkboolean, checkclosure, checkdouble, checkglobals, checkint, checkinteger, checkjstring, checklong, checkmetatag, checknotnil, checknumber, checknumber, checkstring, checktable, checkthread, checkuserdata, checkuserdata, compareerror, compareerror, comparemt, concat, concat, concatmt, concatTo, concatTo, concatTo, div, div, div, divInto, eq_b, eq, eqmtcall, equals, error, get, get, get, gettable, getuservalue, gt_b, gt_b, gt_b, gt, gt, gt, gteq_b, gteq_b, gteq_b, gteq, gteq, gteq, idiv, idiv, illegal, inext, initupvalue1, invoke, invoke, invoke, invoke, invoke, invokemethod, invokemethod, invokemethod, invokemethod, invokemethod, invokemethod, isboolean, isclosure, isint, isinttype, islong, isnil, isnumber, isstring, istable, isthread, isuserdata, isuserdata, isvalidkey, jcall, jget, jset, len, lenerror, length, listOf, listOf, load, lt_b, lt_b, lt_b, lt, lt, lt, lteq_b, lteq_b, lteq_b, lteq, lteq, lteq, metatableOf, metatag, method, method, method, method, method, method, mod, mod, mod, modFrom, mul, mul, mul, narg, neg, neq_b, neq, next, not, onInvoke, 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, rawlen, rawset, rawset, rawset, rawset, rawset, rawset, rawset, rawsetlist, set, set, set, set, set, set, set, setmetatable, settable, setuservalue, shl, shl, shr, shr, strcmp, strcmp, strongvalue, sub, sub, sub, subargs, 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, valueOf, varargsOf, varargsOf, varargsOf, varargsOf, varargsOf, varargsOf

从类继承的方法 org.luaj.vm2.Varargs

argcheck, checkboolean, checkclosure, checkdouble, checkfunction, checkint, checkinteger, checkjstring, checklong, checknotnil, checknumber, checkstring, checktable, checkthread, checkuserdata, checkuserdata, checkvalue, dealias, 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, toboolean, tobyte, tochar, todouble, tofloat, toint, tojstring, tolong, toshort, touserdata, touserdata, type

从类继承的方法 java.lang.Object

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

字段详细资料

FTYPE_STDIN

protected static final int FTYPE_STDIN

Enumerated value representing stdin

另请参阅:

常量字段值

FTYPE_STDOUT

protected static final int FTYPE_STDOUT

Enumerated value representing stdout

另请参阅:

常量字段值

FTYPE_STDERR

protected static final int FTYPE_STDERR

Enumerated value representing stderr

另请参阅:

常量字段值

FTYPE_NAMED

protected static final int FTYPE_NAMED

Enumerated value representing a file type for a named file

另请参阅:

常量字段值

IO_NAMES

public static final String[] IO_NAMES

FILE_NAMES

public static final String[] FILE_NAMES

globals

protected Globals globals

构造器详细资料

IoLib

public IoLib()

方法详细资料

wrapStdin

protected abstract IoLib.File wrapStdin()
                                 throws IOException

Wrap the standard input.

返回:

File

抛出:

IOException

wrapStdout

protected abstract IoLib.File wrapStdout()
                                  throws IOException

Wrap the standard output.

返回:

File

抛出:

IOException

wrapStderr

protected abstract IoLib.File wrapStderr()
                                  throws IOException

Wrap the standard error output.

返回:

File

抛出:

IOException

openFile

protected abstract IoLib.File openFile(String filename,
                                       boolean readMode,
                                       boolean appendMode,
                                       boolean updateMode,
                                       boolean binaryMode)
                                throws IOException

Open a file in a particular mode.

参数:

filename -

readMode - true if opening in read mode

appendMode - true if opening in append mode

updateMode - true if opening in update mode

binaryMode - true if opening in binary mode

返回:

File object if successful

抛出:

IOException - if could not be opened

tmpFile

protected abstract IoLib.File tmpFile()
                               throws IOException

Open a temporary file.

返回:

File object if successful

抛出:

IOException - if could not be opened

openProgram

protected abstract IoLib.File openProgram(String prog,
                                          String mode)
                                   throws IOException

Start a new process and return a file for input or output

参数:

prog - the program to execute

mode - "r" to read, "w" to write

返回:

File to read to or write from

抛出:

IOException - if an i/o exception occurs

call

public LuaValue call(LuaValue modname,
                     LuaValue env)

从类复制的说明: LuaValue

Call this with 2 arguments, including metatag processing, and return only the first return value.

If this is a LuaFunction, call it, and return only its first return value, dropping any others. Otherwise, look for the LuaValue.CALL metatag and call that.

If the return value is a Varargs, only the 1st value will be returned. To get multiple values, use LuaValue.invoke() instead.

To call this as a method call, use LuaValue.method(LuaValue) instead.

指定者:

call 在类中 TwoArgFunction

参数:

modname - First argument to supply to the called function

env - Second argument to supply to the called function

返回:

First return value (this(arg1,arg2)), or LuaValue.NIL if there were none.

另请参阅:

LuaValue.call(), LuaValue.call(LuaValue), LuaValue.call(LuaValue, LuaValue, LuaValue), LuaValue.invoke(LuaValue, Varargs), LuaValue.method(String,LuaValue,LuaValue), LuaValue.method(LuaValue,LuaValue,LuaValue)

_io_flush

public Varargs _io_flush()
                  throws IOException

抛出:

IOException

_io_tmpfile

public Varargs _io_tmpfile()
                    throws IOException

抛出:

IOException

_io_close

public Varargs _io_close(LuaValue file)
                  throws IOException

抛出:

IOException

_io_input

public Varargs _io_input(LuaValue file)

_io_output

public Varargs _io_output(LuaValue filename)

_io_type

public Varargs _io_type(LuaValue obj)

_io_popen

public Varargs _io_popen(String prog,
                         String mode)
                  throws IOException

抛出:

IOException

_io_open

public Varargs _io_open(String filename,
                        String mode)
                 throws IOException

抛出:

IOException

_io_lines

public Varargs _io_lines(Varargs args)

_io_read

public Varargs _io_read(Varargs args)
                 throws IOException

抛出:

IOException

_io_write

public Varargs _io_write(Varargs args)
                  throws IOException

抛出:

IOException

_file_close

public Varargs _file_close(LuaValue file)
                    throws IOException

抛出:

IOException

_file_flush

public Varargs _file_flush(LuaValue file)
                    throws IOException

抛出:

IOException

_file_setvbuf

public Varargs _file_setvbuf(LuaValue file,
                             String mode,
                             int size)

_file_lines

public Varargs _file_lines(Varargs args)

_file_read

public Varargs _file_read(LuaValue file,
                          Varargs subargs)
                   throws IOException

抛出:

IOException

_file_seek

public Varargs _file_seek(LuaValue file,
                          String whence,
                          int offset)
                   throws IOException

抛出:

IOException

_file_write

public Varargs _file_write(LuaValue file,
                           Varargs subargs)
                    throws IOException

抛出:

IOException

_io_index

public Varargs _io_index(LuaValue v)

_lines_iter

public Varargs _lines_iter(LuaValue file,
                           boolean toclose,
                           Varargs args)
                    throws IOException

抛出:

IOException

freadbytes

public static LuaValue freadbytes(IoLib.File f,
                                  int count)
                           throws IOException

抛出:

IOException

freaduntil

public static LuaValue freaduntil(IoLib.File f,
                                  boolean lineonly,
                                  boolean withend)
                           throws IOException

抛出:

IOException

freadline

public static LuaValue freadline(IoLib.File f,
                                 boolean withend)
                          throws IOException

抛出:

IOException

freadall

public static LuaValue freadall(IoLib.File f)
                         throws IOException

抛出:

IOException

freadnumber

public static LuaValue freadnumber(IoLib.File f)
                            throws IOException

抛出:

IOException