| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773 |
- <?xml version="1.0" encoding="UTF-8" ?>
- <NotepadPlus>
- <AutoComplete language="LUA">
- <Environment ignoreCase="yes" startFunc="(" stopFunc=")" paramSeparator="," terminal=";" additionalWordChar=".:" />
- <!-- Lua syntax-->
- <KeyWord name="break" func="no" />
- <KeyWord name="and" func="no" />
- <KeyWord name="do" func="no" />
- <KeyWord name="else" func="no" />
- <KeyWord name="elseif" func="no" />
- <KeyWord name="end" func="no" />
- <KeyWord name="false" func="no" />
- <KeyWord name="for" func="no" />
- <KeyWord name="function" func="no" />
- <KeyWord name="if" func="no" />
- <KeyWord name="in" func="no" />
- <KeyWord name="local" func="no" />
- <KeyWord name="nil" func="no" />
- <KeyWord name="not" func="no" />
- <KeyWord name="or" func="no" />
- <KeyWord name="repeat" func="no" />
- <KeyWord name="return" func="no" />
- <KeyWord name="then" func="no" />
- <KeyWord name="true" func="no" />
- <KeyWord name="until" func="no" />
- <KeyWord name="while" func="no" />
- <!-- Newer syntax additions-->
- <KeyWord name="goto" func="no" />
- <!-- Odd ones out-->
- <KeyWord name="self" func="no" /> <!-- This one still qualifies as a keyword sometimes-->
- <KeyWord name="_G" func="no" /> <!-- May not always exist?-->
- <KeyWord name="_ENV" func="no" /> <!-- May not always exist? And depends on version-->
- <!-- Lua 5.1 standard library-->
- <KeyWord name="_VERSION" func="no" />
- <KeyWord name="assert" func="yes">
- <Overload retVal="void" descr="
- Issues an error when the value of its argument v is false (i.e., nil or false);
- otherwise, returns all its arguments. message is an error message; when absent, it
- defaults to 'assertion failed!'">
- <Param name="Bool:v" />
- <Param name="String:[message]" />
- </Overload>
- </KeyWord>
- <KeyWord name="collectgarbage" func="yes">
- <Overload retVal="void" descr="This function is a generic interface to the garbage collector.
- It performs different functions according to its first argument, opt:
- * 'stop': stops the garbage collector.
- * 'restart': restarts the garbage collector.
- * 'collect': performs a full garbage-collection cycle.
- * 'count': returns the total memory in use by Lua (in Kbytes).
- * 'step': performs a garbage-collection step. The step 'size' is controlled by arg
- (larger values mean more steps) in a non-specified way. If you want to control
- the step size you must experimentally tune the value of arg. Returns true if
- the step finished a collection cycle.
- * 'setpause': sets arg as the new value for the pause of the collector (see §2.10).
- Returns the previous value for pause.
- * 'setstepmul': sets arg as the new value for the step multiplier of the collector
- (see §2.10). Returns the previous value for step.
- ">
- <Param name="String:opt" />
- <Param name="[arg]" />
- </Overload>
- </KeyWord>
- <KeyWord name="coroutine.create" func="yes">
- <Overload retVal="void" descr="
- Creates a new coroutine, with body f. f must be a Lua function. Returns this new
- coroutine, an object with type 'thread'.
- ">
- <Param name="Function:f" />
- </Overload>
- </KeyWord>
- <KeyWord name="coroutine.resume" func="yes">
- <Overload retVal="void" descr="
- Starts or continues the execution of coroutine co. The first time you resume a
- coroutine, it starts running its body. The values val1, ··· are passed as the
- arguments to the body function. If the coroutine has yielded, resume restarts it; the
- values val1, ··· are passed as the results from the yield.
- If the coroutine runs without any errors, resume returns true plus any values passed
- to yield (if the coroutine yields) or any values returned by the body function (if the
- coroutine terminates). If there is any error, resume returns false plus the error
- message.
- ">
- <Param name="co" />
- <Param name="[, val, ...]" />
- </Overload>
- </KeyWord>
- <KeyWord name="coroutine.running" func="yes">
- <Overload retVal="void" descr="
- Returns the running coroutine, or nil when called by the main thread.
- "></Overload>
- </KeyWord>
- <KeyWord name="coroutine.status" func="yes">
- <Overload retVal="void" descr="
- Returns the status of coroutine co, as a string: 'running', if the coroutine is running (that is, it called status);
- 'suspended', if the coroutine is suspended in a call to yield, or if it has not started running yet;
- 'normal' if the coroutine is active but not running (that is, it has resumed another coroutine); and
- 'dead' if the coroutine has finished its body function, or if it has stopped with an error.
- ">
- <Param name="co" />
- </Overload>
- </KeyWord>
- <KeyWord name="coroutine.wrap" func="yes">
- <Overload retVal="void" descr="
- Creates a new coroutine, with body f. f must be a Lua function. Returns a function that resumes
- the coroutine each time it is called. Any arguments passed to the function behave as the extra
- arguments to resume. Returns the same values returned by resume, except the first boolean. In
- case of error, propagates the error.
- ">
- <Param name="f" />
- </Overload>
- </KeyWord>
- <KeyWord name="coroutine.yield" func="yes">
- <Overload retVal="void" descr="
- Suspends the execution of the calling coroutine. The coroutine cannot be running a C function, a
- metamethod, or an iterator. Any arguments to yield are passed as extra results to resume.
- ">
- <Param name="..." />
- </Overload>
- </KeyWord>
- <KeyWord name="debug.debug" func="yes">
- <Overload retVal="void" descr="
- Enters an interactive mode with the user, running each string that the user enters. Using
- simple commands and other debug facilities, the user can inspect global and local variables,
- change their values, evaluate expressions, and so on. A line containing only the word cont
- finishes this function, so that the caller continues its execution.
- Note that commands for debug.debug are not lexically nested within any function, and so
- have no direct access to local variables.
- "></Overload>
- </KeyWord>
- <KeyWord name="debug.getfenv" func="yes">
- <Overload retVal="void" descr="
- Returns the environment of object o.
- ">
- <Param name="o" />
- </Overload>
- </KeyWord>
- <KeyWord name="debug.gethook" func="yes">
- <Overload retVal="void" descr="
- Returns the current hook settings of the thread, as three values: the current hook function, the
- current hook mask, and the current hook count (as set by the debug.sethook function).
- ">
- <Param name="[thread]" />
- </Overload>
- </KeyWord>
- <KeyWord name="debug.getinfo" func="yes">
- <Overload retVal="void" descr="
- Returns a table with information about a function. You can give the function directly, or you
- can give a number as the value of function, which means the function running at level function
- of the call stack of the given thread: level 0 is the current function (getinfo itself); level 1
- is the function that called getinfo; and so on. If function is a number larger than the number
- of active functions, then getinfo returns nil.
- The returned table can contain all the fields returned by lua_getinfo, with the string what
- describing which fields to fill in. The default for what is to get all information available,
- except the table of valid lines. If present, the option 'f' adds a field named func with the
- function itself. If present, the option 'L' adds a field named activelines with the table of
- valid lines.
- For instance, the expression debug.getinfo(1,'n').name returns a table with a name for the current
- function, if a reasonable name can be found, and the expression debug.getinfo(print) returns a table
- with all available information about the print function.
- ">
- <Param name="[thread,]" />
- <Param name="function" />
- <Param name="[, what]" />
- </Overload>
- </KeyWord>
- <KeyWord name="debug.getlocal" func="yes">
- <Overload retVal="void" descr="
- This function returns the name and the value of the local variable with index local of the function
- at level level of the stack. (The first parameter or local variable has index 1, and so on, until the
- last active local variable.) The function returns nil if there is no local variable with the given index,
- and raises an error when called with a level out of range. (You can call debug.getinfo to check whether
- the level is valid.)
- Variable names starting with '(' (open parentheses) represent internal variables (loop control variables,
- temporaries, and C function locals).
- ">
- <Param name="[thread,]" />
- <Param name="level" />
- <Param name="local" />
- </Overload>
- </KeyWord>
- <KeyWord name="debug.getmetatable" func="yes">
- <Overload retVal="void" descr="
- Returns the metatable of the given object or nil if it does not have a metatable.
- ">
- <Param name="object" />
- </Overload>
- </KeyWord>
- <KeyWord name="debug.getregistry" func="yes">
- <Overload retVal="void" descr="
- Returns the registry table (see §3.5).
- "></Overload>
- </KeyWord>
- <KeyWord name="debug.getupvalue" func="yes">
- <Overload retVal="void" descr="
- This function returns the name and the value of the upvalue with index up of the function
- func. The function returns nil if there is no upvalue with the given index.
- ">
- <Param name="func" />
- <Param name="up" />
- </Overload>
- </KeyWord>
- <KeyWord name="debug.setfenv" func="yes">
- <Overload retVal="void" descr="
- Sets the environment of the given object to the given table. Returns object.
- ">
- <Param name="object" />
- <Param name="table" />
- </Overload>
- </KeyWord>
- <KeyWord name="debug.sethook" func="yes">
- <Overload retVal="void" descr="
- Sets the given function as a hook. The string mask and the number count describe when the hook
- will be called. The string mask may have the following characters, with the given meaning:
- * 'c': the hook is called every time Lua calls a function;
- * 'r': the hook is called every time Lua returns from a function;
- * 'l': the hook is called every time Lua enters a new line of code.
- With a count different from zero, the hook is called after every count instructions.
- When called without arguments, debug.sethook turns off the hook.
- When the hook is called, its first parameter is a string describing the event that has triggered
- its call: 'call', 'return' (or 'tail return', when simulating a return from a tail call), 'line',
- and 'count'. For line events, the hook also gets the new line number as its second parameter.
- Inside a hook, you can call getinfo with level 2 to get more information about the running function
- (level 0 is the getinfo function, and level 1 is the hook function), unless the event is 'tail return'.
- In this case, Lua is only simulating the return, and a call to getinfo will return invalid data.
- ">
- <Param name="[thread,]" />
- <Param name="hook" />
- <Param name="mask" />
- <Param name="[, count]" />
- </Overload>
- </KeyWord>
- <KeyWord name="debug.setlocal" func="yes">
- <Overload retVal="void" descr="
- This function assigns the value value to the local variable with index local of the function at level
- level of the stack. The function returns nil if there is no local variable with the given index, and
- raises an error when called with a level out of range. (You can call getinfo to check whether the level
- is valid.) Otherwise, it returns the name of the local variable.
- ">
- <Param name="[thread,]" />
- <Param name="level" />
- <Param name="local" />
- <Param name="value" />
- </Overload>
- </KeyWord>
- <KeyWord name="debug.setmetatable" func="yes">
- <Overload retVal="void" descr="
- Sets the metatable for the given object to the given table (which can be nil).
- ">
- <Param name="object" />
- <Param name="table" />
- </Overload>
- </KeyWord>
- <KeyWord name="debug.setupvalue" func="yes">
- <Overload retVal="void" descr="
- This function assigns the value value to the upvalue with index up of the function func. The function
- returns nil if there is no upvalue with the given index. Otherwise, it returns the name of the upvalue.
- ">
- <Param name="func" />
- <Param name="up" />
- <Param name="value" />
- </Overload>
- </KeyWord>
- <KeyWord name="debug.traceback" func="yes">
- <Overload retVal="void" descr="
- Returns a string with a traceback of the call stack. An optional message string is appended at the
- beginning of the traceback. An optional level number tells at which level to start the traceback
- (default is 1, the function calling traceback).
- ">
- <Param name="[thread,]" />
- <Param name="[message]" />
- <Param name="[, level]" />
- </Overload>
- </KeyWord>
- <KeyWord name="dofile" func="yes">
- <Overload retVal="void" descr="
- Opens the named file and executes its contents as a Lua chunk. When called without arguments, dofile
- executes the contents of the standard input (stdin). Returns all values returned by the chunk. In case
- of errors, dofile propagates the error to its caller (that is, dofile does not run in protected mode).
- ">
- <Param name="filename" />
- </Overload>
- </KeyWord>
- <KeyWord name="error" func="yes">
- <Overload retVal="void" descr="
- Terminates the last protected function called and returns message as the error message.
- Function error never returns.
- Usually, error adds some information about the error position at the beginning of the message.
- The level argument specifies how to get the error position. With level 1 (the default), the error
- position is where the error function was called. Level 2 points the error to where the function
- that called error was called; and so on. Passing a level 0 avoids the addition of error position
- information to the message.
- ">
- <Param name="message" />
- <Param name="[, level]" />
- </Overload>
- </KeyWord>
- <KeyWord name="file:close" func="yes">
- <Overload retVal="void" descr="
- Closes file. Note that files are automatically closed when their handles are garbage collected,
- but that takes an unpredictable amount of time to happen.
- "></Overload>
- </KeyWord>
- <KeyWord name="file:flush" func="yes">
- <Overload retVal="void" descr="
- Saves any written data to file.
- "></Overload>
- </KeyWord>
- <KeyWord name="file:lines" func="yes">
- <Overload retVal="void" descr="
- Returns an iterator function that, each time it is called, returns a new line from the file.
- Therefore, the construction
- for line in file:lines() do body end
- will iterate over all lines of the file. (Unlike io.lines, this function does not close the file when the loop ends.)
- "></Overload>
- </KeyWord>
- <KeyWord name="file:read" func="yes">
- <Overload retVal="void" descr="
- Reads the file file, according to the given formats, which specify what to read. For each format,
- the function returns a string (or a number) with the characters read, or nil if it cannot read data
- with the specified format. When called without formats, it uses a default format that reads the entire
- next line (see below).
- The available formats are
- * '*n': reads a number; this is the only format that returns a number instead of a string.
- * '*a': reads the whole file, starting at the current position. On end of file, it returns the empty string.
- * '*l': reads the next line (skipping the end of line), returning nil on end of file. This is the default format.
- * number: reads a string with up to this number of characters, returning nil on end of file. If number is zero, it
- reads nothing and returns an empty string, or nil on end of file.
- ">
- <Param name="···" />
- </Overload>
- </KeyWord>
- <KeyWord name="file:seek" func="yes">
- <Overload retVal="void" descr="
- Sets and gets the file position, measured from the beginning of the file, to the position given by offset
- plus a base specified by the string whence, as follows:
- * 'set': base is position 0 (beginning of the file);
- * 'cur': base is current position;
- * 'end': base is end of file;
- In case of success, function seek returns the final file position, measured in bytes from the beginning of the
- file. If this function fails, it returns nil, plus a string describing the error.
- The default value for whence is 'cur', and for offset is 0. Therefore, the call file:seek() returns the
- current file position, without changing it; the call file:seek('set') sets the position to the beginning
- of the file (and returns 0); and the call file:seek('end') sets the position to the end of the file, and
- returns its size.
- ">
- <Param name="[whence]" />
- <Param name="[, offset]" />
- </Overload>
- </KeyWord>
- <KeyWord name="file:setvbuf" func="yes">
- <Overload retVal="void" descr="
- Sets the buffering mode for an output file. There are three available modes:
- * 'no': no buffering; the result of any output operation appears immediately.
- * 'full': full buffering; output operation is performed only when the buffer is full
- (or when you explicitly flush the file (see io.flush)).
- * 'line': line buffering; output is buffered until a newline is output or there is any input
- from some special files (such as a terminal device).
- For the last two cases, size specifies the size of the buffer, in bytes. The default is an appropriate size.
- ">
- <Param name="mode" />
- <Param name="[, size]" />
- </Overload>
- </KeyWord>
- <KeyWord name="file:write" func="yes">
- <Overload retVal="void" descr="
- Writes the value of each of its arguments to the file. The arguments must be strings or numbers. To write
- other values, use tostring or string.format before write.
- ">
- <Param name="···" />
- </Overload>
- </KeyWord>
- <KeyWord name="getfenv" func="yes">
- <Overload retVal="void" descr="
- Returns the current environment in use by the function. f can be a Lua function or a number that specifies
- the function at that stack level: Level 1 is the function calling getfenv. If the given function is not a
- Lua function, or if f is 0, getfenv returns the global environment. The default for f is 1.
- ">
- <Param name="[f]" />
- </Overload>
- </KeyWord>
- <KeyWord name="getmetatable" func="yes">
- <Overload retVal="void" descr="
- If object does not have a metatable, returns nil. Otherwise, if the object's metatable has a '__metatable'
- field, returns the associated value. Otherwise, returns the metatable of the given object.
- ">
- <Param name="object" />
- </Overload>
- </KeyWord>
- <KeyWord name="io.close" func="yes">
- <Overload retVal="void" descr="
- Equivalent to file:close(). Without a file, closes the default output file.
- ">
- <Param name="[file]" />
- </Overload>
- </KeyWord>
- <KeyWord name="io.flush" func="yes">
- <Overload retVal="void" descr="
- Equivalent to file:flush over the default output file.
- "></Overload>
- </KeyWord>
- <KeyWord name="io.input" func="yes">
- <Overload retVal="void" descr="
- When called with a file name, it opens the named file (in text mode), and sets its handle as the default
- input file. When called with a file handle, it simply sets this file handle as the default input file. When
- called without parameters, it returns the current default input file.
- In case of errors this function raises the error, instead of returning an error code.
- ">
- <Param name="[file]" />
- </Overload>
- </KeyWord>
- <KeyWord name="io.lines" func="yes">
- <Overload retVal="void" descr="
- Opens the given file name in read mode and returns an iterator function that, each time it is called,
- returns a new line from the file. Therefore, the construction
- for line in io.lines(filename) do body end
- will iterate over all lines of the file. When the iterator function detects the end of file, it returns
- nil (to finish the loop) and automatically closes the file.
- The call io.lines() (with no file name) is equivalent to io.input():lines(); that is, it iterates over
- the lines of the default input file. In this case it does not close the file when the loop ends.
- ">
- <Param name="[filename]" />
- </Overload>
- </KeyWord>
- <KeyWord name="io.open" func="yes">
- <Overload retVal="void" descr="
- This function opens a file, in the mode specified in the string mode. It returns a new file handle,
- or, in case of errors, nil plus an error message.
- The mode string can be any of the following:
- * 'r': read mode (the default);
- * 'w': write mode;
- * 'a': append mode;
- * 'r+': update mode, all previous data is preserved;
- * 'w+': update mode, all previous data is erased;
- * 'a+': append update mode, previous data is preserved, writing is only allowed at the end of file.
- The mode string can also have a 'b' at the end, which is needed in some systems to open the file in
- binary mode. This string is exactly what is used in the standard C function fopen.
- ">
- <Param name="filename" />
- <Param name="[, mode]" />
- </Overload>
- </KeyWord>
- <KeyWord name="io.output" func="yes">
- <Overload retVal="void" descr="
- Similar to io.input, but operates over the default output file.
- ">
- <Param name="[file]" />
- </Overload>
- </KeyWord>
- <KeyWord name="io.popen" func="yes">
- <Overload retVal="void" descr="
- Starts program prog in a separated process and returns a file handle that you can use to read data from
- this program (if mode is 'r', the default) or to write data to this program (if mode is 'w').
- This function is system dependent and is not available on all platforms.
- ">
- <Param name="prog" />
- <Param name="[, mode]" />
- </Overload>
- </KeyWord>
- <KeyWord name="io.read" func="yes">
- <Overload retVal="void" descr="
- Equivalent to io.input():read.
- ">
- <Param name="···" />
- </Overload>
- </KeyWord>
- <KeyWord name="io.tmpfile" func="yes">
- <Overload retVal="void" descr="
- Returns a handle for a temporary file. This file is opened in update mode and it is automatically
- removed when the program ends.
- "></Overload>
- </KeyWord>
- <KeyWord name="io.type" func="yes">
- <Overload retVal="void" descr="
- Checks whether obj is a valid file handle. Returns the string 'file' if obj is an open file handle,
- 'closed file' if obj is a closed file handle, or nil if obj is not a file handle.
- ">
- <Param name="obj" />
- </Overload>
- </KeyWord>
- <KeyWord name="io.write" func="yes">
- <Overload retVal="void" descr="
- Equivalent to io.output():write.
- ">
- <Param name="···" />
- </Overload>
- </KeyWord>
- <KeyWord name="ipairs" func="yes">
- <Overload retVal="void" descr="
- Returns three values: an iterator function, the table t, and 0, so that the construction
- for i,v in ipairs(t) do body end
- will iterate over the pairs (1,t[1]), (2,t[2]), ···, up to the first integer key absent from the table.
- ">
- <Param name="t" />
- </Overload>
- </KeyWord>
- <KeyWord name="load" func="yes">
- <Overload retVal="void" descr="
- Loads a chunk using function func to get its pieces. Each call to func must return a string that
- concatenates with previous results. A return of an empty string, nil, or no value signals the end of
- the chunk.
- If there are no errors, returns the compiled chunk as a function; otherwise, returns nil plus the error
- message. The environment of the returned function is the global environment.
- chunkname is used as the chunk name for error messages and debug information. When absent,
- it defaults to '=(load)'.
- ">
- <Param name="func" />
- <Param name="[, chunkname]" />
- </Overload>
- </KeyWord>
- <KeyWord name="loadfile" func="yes">
- <Overload retVal="void" descr="
- Similar to load, but gets the chunk from file filename or from the standard input,
- if no file name is given.
- ">
- <Param name="[filename]" />
- </Overload>
- </KeyWord>
- <KeyWord name="loadstring" func="yes">
- <Overload retVal="void" descr="
- Similar to load, but gets the chunk from the given string.
- To load and run a given string, use the idiom
- assert(loadstring(s))()
- When absent, chunkname defaults to the given string.
- ">
- <Param name="string" />
- <Param name="[, chunkname]" />
- </Overload>
- </KeyWord>
- <KeyWord name="math.abs" func="yes">
- <Overload retVal="void" descr="
- Returns the absolute value of x.
- ">
- <Param name="x" />
- </Overload>
- </KeyWord>
- <KeyWord name="math.acos" func="yes">
- <Overload retVal="void" descr="
- Returns the arc cosine of x (in radians).
- ">
- <Param name="x" />
- </Overload>
- </KeyWord>
- <KeyWord name="math.asin" func="yes">
- <Overload retVal="void" descr="
- Returns the arc sine of x (in radians).
- ">
- <Param name="x" />
- </Overload>
- </KeyWord>
- <KeyWord name="math.atan" func="yes">
- <Overload retVal="void" descr="
- Returns the arc tangent of x (in radians).
- ">
- <Param name="x" />
- </Overload>
- </KeyWord>
- <KeyWord name="math.atan2" func="yes">
- <Overload retVal="void" descr="
- Returns the arc tangent of y/x (in radians), but uses the signs of both parameters to
- find the quadrant of the result. (It also handles correctly the case of x being zero.)
- ">
- <Param name="y" />
- <Param name="x" />
- </Overload>
- </KeyWord>
- <KeyWord name="math.ceil" func="yes">
- <Overload retVal="void" descr="
- Returns the smallest integer larger than or equal to x.
- ">
- <Param name="x" />
- </Overload>
- </KeyWord>
- <KeyWord name="math.cos" func="yes">
- <Overload retVal="void" descr="
- Returns the cosine of x (assumed to be in radians).
- ">
- <Param name="x" />
- </Overload>
- </KeyWord>
- <KeyWord name="math.cosh" func="yes">
- <Overload retVal="void" descr="
- Returns the hyperbolic cosine of x.
- ">
- <Param name="x" />
- </Overload>
- </KeyWord>
- <KeyWord name="math.deg" func="yes">
- <Overload retVal="void" descr="
- Returns the angle x (given in radians) in degrees.
- ">
- <Param name="x" />
- </Overload>
- </KeyWord>
- <KeyWord name="math.exp" func="yes">
- <Overload retVal="void" descr="
- Returns the value ex.
- ">
- <Param name="x" />
- </Overload>
- </KeyWord>
- <KeyWord name="math.floor" func="yes">
- <Overload retVal="void" descr="
- Returns the largest integer smaller than or equal to x.
- ">
- <Param name="x" />
- </Overload>
- </KeyWord>
- <KeyWord name="math.fmod" func="yes">
- <Overload retVal="void" descr="
- Returns the remainder of the division of x by y that rounds the quotient towards zero.
- ">
- <Param name="x" />
- <Param name="y" />
- </Overload>
- </KeyWord>
- <KeyWord name="math.frexp" func="yes">
- <Overload retVal="void" descr="
- Returns m and e such that x = m2e, e is an integer and the absolute value of m is in
- the range [0.5, 1) (or zero when x is zero).
- ">
- <Param name="x" />
- </Overload>
- </KeyWord>
- <KeyWord name="math.huge" func="no" />
- <KeyWord name="math.ldexp" func="yes">
- <Overload retVal="void" descr="
- Returns m2e (e should be an integer).
- ">
- <Param name="m" />
- <Param name="e" />
- </Overload>
- </KeyWord>
- <KeyWord name="math.log" func="yes">
- <Overload retVal="void" descr="
- Returns the natural logarithm of x.
- ">
- <Param name="x" />
- </Overload>
- </KeyWord>
- <KeyWord name="math.log10" func="yes">
- <Overload retVal="void" descr="
- Returns the base-10 logarithm of x.
- ">
- <Param name="x" />
- </Overload>
- </KeyWord>
- <KeyWord name="math.max" func="yes">
- <Overload retVal="void" descr="
- Returns the maximum value among its arguments.
- ">
- <Param name="x" />
- <Param name="..." />
- </Overload>
- </KeyWord>
- <KeyWord name="math.min" func="yes">
- <Overload retVal="void" descr="
- Returns the minimum value among its arguments.
- ">
- <Param name="x" />
- <Param name="..." />
- </Overload>
- </KeyWord>
- <KeyWord name="math.modf" func="yes">
- <Overload retVal="void" descr="
- Returns two numbers, the integral part of x and the fractional part of x.
- ">
- <Param name="x" />
- </Overload>
- </KeyWord>
- <KeyWord name="math.pi" func="no" />
- <KeyWord name="math.pow" func="yes">
- <Overload retVal="void" descr="
- Returns xy. (You can also use the expression x^y to compute this value.)
- ">
- <Param name="x" />
- <Param name="y" />
- </Overload>
- </KeyWord>
- <KeyWord name="math.rad" func="yes">
- <Overload retVal="void" descr="
- Returns the angle x (given in degrees) in radians.
- ">
- <Param name="x" />
- </Overload>
- </KeyWord>
- <KeyWord name="math.random" func="yes">
- <Overload retVal="void" descr="
- This function is an interface to the simple pseudo-random generator function rand
- provided by ANSI C. (No guarantees can be given for its statistical properties.)
- When called without arguments, returns a uniform pseudo-random real number in the
- range [0,1). When called with an integer number m, math.random returns a uniform
- pseudo-random integer in the range [1, m]. When called with two integer numbers m and
- n, math.random returns a uniform pseudo-random integer in the range [m, n].
- ">
- <Param name="[m [, n]]" />
- </Overload>
- </KeyWord>
- <KeyWord name="math.randomseed" func="yes">
- <Overload retVal="void" descr="
- Sets x as the 'seed' for the pseudo-random generator: equal seeds produce equal
- sequences of numbers.
- ">
- <Param name="x" />
- </Overload>
- </KeyWord>
- <KeyWord name="math.sin" func="yes">
- <Overload retVal="void" descr="
- Returns the sine of x (assumed to be in radians).
- ">
- <Param name="x" />
- </Overload>
- </KeyWord>
- <KeyWord name="math.sinh" func="yes">
- <Overload retVal="void" descr="
- Returns the hyperbolic sine of x.
- ">
- <Param name="x" />
- </Overload>
- </KeyWord>
- <KeyWord name="math.sqrt" func="yes">
- <Overload retVal="void" descr="
- Returns the square root of x. (You can also use the expression x^0.5 to compute this value.)
- ">
- <Param name="x" />
- </Overload>
- </KeyWord>
- <KeyWord name="math.tan" func="yes">
- <Overload retVal="void" descr="
- Returns the tangent of x (assumed to be in radians).
- ">
- <Param name="x" />
- </Overload>
- </KeyWord>
- <KeyWord name="math.tanh" func="yes">
- <Overload retVal="void" descr="
- Returns the hyperbolic tangent of x.
- ">
- <Param name="x" />
- </Overload>
- </KeyWord>
- <KeyWord name="module" func="yes">
- <Overload retVal="void" descr="
- Creates a module. If there is a table in package.loaded[name], this table is the module.
- Otherwise, if there is a global table t with the given name, this table is the module.
- Otherwise creates a new table t and sets it as the value of the global name and the value
- of package.loaded[name]. This function also initializes t._NAME with the given name, t._M
- with the module (t itself), and t._PACKAGE with the package name (the full module name
- minus last component; see below). Finally, module sets t as the new environment of the
- current function and the new value of package.loaded[name], so that require returns t.
- If name is a compound name (that is, one with components separated by dots), module creates
- (or reuses, if they already exist) tables for each component. For instance, if name is a.b.c,
- then module stores the module table in field c of field b of global a.
- This function can receive optional options after the module name, where each option is a
- function to be applied over the module.
- ">
- <Param name="name" />
- <Param name="[, ···]" />
- </Overload>
- </KeyWord>
- <KeyWord name="next" func="yes">
- <Overload retVal="void" descr="
- Allows a program to traverse all fields of a table. Its first argument is a table and its second
- argument is an index in this table. next returns the next index of the table and its associated
- value. When called with nil as its second argument, next returns an initial index and its associated
- value. When called with the last index, or with nil in an empty table, next returns nil. If the
- second argument is absent, then it is interpreted as nil. In particular, you can use next(t) to
- check whether a table is empty.
- The order in which the indices are enumerated is not specified, even for numeric indices. (To
- traverse a table in numeric order, use a numerical for or the ipairs function.)
- The behavior of next is undefined if, during the traversal, you assign any value to a non-existent
- field in the table. You may however modify existing fields. In particular, you may clear existing
- fields.
- ">
- <Param name="table" />
- <Param name="[, index]" />
- </Overload>
- </KeyWord>
- <KeyWord name="os.clock" func="yes">
- <Overload retVal="void" descr="
- Returns an approximation of the amount in seconds of CPU time used by the program.
- "></Overload>
- </KeyWord>
- <KeyWord name="os.date" func="yes">
- <Overload retVal="void" descr="
- Returns a string or a table containing date and time, formatted according to the given string format.
- If the time argument is present, this is the time to be formatted (see the os.time function
- for a description of this value). Otherwise, date formats the current time.
- If format starts with '!', then the date is formatted in Coordinated Universal Time. After this
- optional character, if format is the string '*t', then date returns a table with the following fields:
- year (four digits),
- month (1--12),
- day (1--31),
- hour (0--23),
- min (0--59),
- sec (0--61),
- wday (weekday, Sunday is 1),
- yday (day of the year), and
- isdst (daylight saving flag, a boolean).
- If format is not '*t', then date returns the date as a string, formatted according to the same
- rules as the C function strftime.
- When called without arguments, date returns a reasonable date and time representation that
- depends on the host system and on the current locale (that is, os.date() is equivalent to os.date('%c')).
- ">
- <Param name="[format [, time]]" />
- </Overload>
- </KeyWord>
- <KeyWord name="os.difftime" func="yes">
- <Overload retVal="void" descr="
- Returns the number of seconds from time t1 to time t2. In POSIX, Windows, and some other systems,
- this value is exactly t2-t1.
- ">
- <Param name="t2" />
- <Param name="t1" />
- </Overload>
- </KeyWord>
- <KeyWord name="os.execute" func="yes">
- <Overload retVal="void" descr="
- 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.
- ">
- <Param name="[command]" />
- </Overload>
- </KeyWord>
- <KeyWord name="os.exit" func="yes">
- <Overload retVal="void" descr="
- Calls the C function exit, with an optional code, to terminate the host program. The default
- value for code is the success code.
- ">
- <Param name="[code]" />
- </Overload>
- </KeyWord>
- <KeyWord name="os.getenv" func="yes">
- <Overload retVal="void" descr="
- Returns the value of the process environment variable varname, or nil if the variable is not defined.
- ">
- <Param name="varname" />
- </Overload>
- </KeyWord>
- <KeyWord name="os.remove" func="yes">
- <Overload retVal="void" descr="
- Deletes the file or directory with the given name. Directories must be empty to be removed. If this
- function fails, it returns nil, plus a string describing the error.
- ">
- <Param name="filename" />
- </Overload>
- </KeyWord>
- <KeyWord name="os.rename" func="yes">
- <Overload retVal="void" descr="
- Renames file or directory named oldname to newname. If this function fails, it returns nil, plus a
- string describing the error.
- ">
- <Param name="oldname" />
- <Param name="newname" />
- </Overload>
- </KeyWord>
- <KeyWord name="os.setlocale" func="yes">
- <Overload retVal="void" descr="
- Sets the current locale of the program. locale is a string specifying a locale; category is an optional
- string describing which category to change: 'all', 'collate', 'ctype', 'monetary', 'numeric', or 'time';
- the default category is 'all'. The function returns the name of the new locale, or nil if the request
- cannot be honored.
- If locale is the empty string, the current locale is set to an implementation-defined native locale. If
- locale is the string 'C', the current locale is set to the standard C locale.
- When called with nil as the first argument, this function only returns the name of the current locale
- for the given category.
- ">
- <Param name="locale" />
- <Param name="[, category]" />
- </Overload>
- </KeyWord>
- <KeyWord name="os.time" func="yes">
- <Overload retVal="void" descr="
- Returns the current time when called without arguments, or a time representing the date and time specified
- by the given table. This table must have fields year, month, and day, and may have fields hour, min, sec,
- and isdst (for a description of these fields, see the os.date function).
- The returned value is a number, whose meaning depends on your system. In POSIX, Windows, and some other
- systems, this number counts the number of seconds since some given start time (the 'epoch').
- In other systems, the meaning is not specified, and the number returned by time can be used only as an
- argument to date and difftime.
- ">
- <Param name="[table]" />
- </Overload>
- </KeyWord>
- <KeyWord name="os.tmpname" func="yes">
- <Overload retVal="void" descr="
- 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).
- When possible, you may prefer to use io.tmpfile, which automatically removes the file when the program ends.
- "></Overload>
- </KeyWord>
- <KeyWord name="package.cpath" func="no" />
- <KeyWord name="package.loaded" func="no" />
- <KeyWord name="package.loaders" func="no" />
- <KeyWord name="package.loadlib" func="yes">(libname, funcname)
- <Overload retVal="void" descr="
- Dynamically links the host program with the C library libname. Inside this library, looks for a function
- funcname and returns this function as a C function. (So, funcname must follow the protocol (see lua_CFunction)).
- This is a low-level function. It completely bypasses the package and module system. Unlike require, it
- does not perform any path searching and does not automatically adds extensions. libname must be the complete
- file name of the C library, including if necessary a path and extension. funcname must be the exact name
- exported by the C library (which may depend on the C compiler and linker used).
- This function is not supported by ANSI C. As such, it is only available on some platforms (Windows,
- Linux, Mac OS X, Solaris, BSD, plus other Unix systems that support the dlfcn standard).
- ">
- <Param name="libname" />
- <Param name="funcname" />
- </Overload>
- </KeyWord>
- <KeyWord name="package.path" func="no" />
- <KeyWord name="package.preload" func="no" />
- <KeyWord name="package.seeall" func="yes">(module)
- <Overload retVal="void" descr="
- Sets a metatable for module with its __index field referring to the global environment, so that this
- module inherits values from the global environment. To be used as an option to function module.
- ">
- <Param name="module" />
- </Overload>
- </KeyWord>
- <KeyWord name="pairs" func="yes">
- <Overload retVal="void" descr="
- Returns three values: the next function, the table t, and nil, so that the construction
- for k,v in pairs(t) do body end
- will iterate over all key–value pairs of table t.
- See function next for the caveats of modifying the table during its traversal.
- ">
- <Param name="t" />
- </Overload>
- </KeyWord>
- <KeyWord name="pcall" func="yes">
- <Overload retVal="void" descr="
- Calls function f with the given arguments in protected mode. This means that any error
- inside f is not propagated; instead, pcall catches the error and returns a status code.
- Its first result is the status code (a boolean), which is true if the call succeeds without
- errors. In such case, pcall also returns all results from the call, after this first result.
- In case of any error, pcall returns false plus the error message.
- ">
- <Param name="f" />
- <Param name="arg1" />
- <Param name="···" />
- </Overload>
- </KeyWord>
- <KeyWord name="print" func="yes">
- <Overload retVal="void" descr="
- Receives any number of arguments, and prints their values to stdout, using the tostring
- function to convert them to strings. print is not intended for formatted output, but only
- as a quick way to show a value, typically for debugging. For formatted output, use string.format.
- ">
- <Param name="···" />
- </Overload>
- </KeyWord>
- <KeyWord name="rawequal" func="yes">
- <Overload retVal="void" descr="
- Checks whether v1 is equal to v2, without invoking any metamethod. Returns a boolean.
- ">
- <Param name="v1" />
- <Param name="v2" />
- </Overload>
- </KeyWord>
- <KeyWord name="rawget" func="yes">
- <Overload retVal="void" descr="
- Gets the real value of table[index], without invoking any metamethod. table must be a
- table; index may be any value.
- ">
- <Param name="table" />
- <Param name="index" />
- </Overload>
- </KeyWord>
- <KeyWord name="rawset" func="yes">
- <Overload retVal="void" descr="
- Sets the real value of table[index] to value, without invoking any metamethod. table must
- be a table, index any value different from nil, and value any Lua value.
- This function returns table.
- ">
- <Param name="table" />
- <Param name="index" />
- <Param name="value" />
- </Overload>
- </KeyWord>
- <KeyWord name="require" func="yes">
- <Overload retVal="void" descr="
- Loads the given module. The function starts by looking into the package.loaded table to
- determine whether modname is already loaded. If it is, then require returns the value stored
- at package.loaded[modname]. Otherwise, it tries to find a loader for the module.
- To find a loader, require is guided by the package.loaders array. By changing this array,
- we can change how require looks for a module. The following explanation is based on the
- default configuration for package.loaders.
- First require queries package.preload[modname]. If it has a value, this value (which should
- be a function) is the loader. Otherwise require searches for a Lua loader using the path
- stored in package.path. If that also fails, it searches for a C loader using the path stored
- in package.cpath. If that also fails, it tries an all-in-one loader (see package.loaders).
- Once a loader is found, require calls the loader with a single argument, modname. If the
- loader returns any value, require assigns the returned value to package.loaded[modname].
- If the loader returns no value and has not assigned any value to package.loaded[modname],
- then require assigns true to this entry. In any case, require returns the final value of
- package.loaded[modname].
- If there is any error loading or running the module, or if it cannot find any loader for
- the module, then require signals an error.
- ">
- <Param name="modname" />
- </Overload>
- </KeyWord>
- <KeyWord name="select" func="yes">
- <Overload retVal="void" descr="
- If index is a number, returns all arguments after argument number index. Otherwise, index
- must be the string '#', and select returns the total number of extra arguments it received.
- ">
- <Param name="index" />
- <Param name="···" />
- </Overload>
- </KeyWord>
- <KeyWord name="setfenv" func="yes">
- <Overload retVal="void" descr="
- Sets the environment to be used by the given function. f can be a Lua function or a number
- that specifies the function at that stack level: Level 1 is the function calling setfenv.
- setfenv returns the given function.
- As a special case, when f is 0 setfenv changes the environment of the running thread.
- In this case, setfenv returns no values.
- ">
- <Param name="f" />
- <Param name="table" />
- </Overload>
- </KeyWord>
- <KeyWord name="setmetatable" func="yes">
- <Overload retVal="void" descr="
- Sets the metatable for the given table. (You cannot change the metatable of other types
- from Lua, only from C.) If metatable is nil, removes the metatable of the given table.
- If the original metatable has a '__metatable' field, raises an error.
- This function returns table.
- ">
- <Param name="table" />
- <Param name="metatable" />
- </Overload>
- </KeyWord>
- <KeyWord name="string.byte" func="yes">
- <Overload retVal="void" descr="
- Returns the internal numerical codes of the characters s[i], s[i+1], ···, s[j]. The default
- value for i is 1; the default value for j is i.
- Note that numerical codes are not necessarily portable across platforms.
- ">
- <Param name="s [, i [, j]]" />
- </Overload>
- </KeyWord>
- <KeyWord name="string.char" func="yes">
- <Overload retVal="void" descr="
- Receives zero or more integers. Returns a string with length equal to the number of arguments,
- in which each character has the internal numerical code equal to its corresponding argument.
- Note that numerical codes are not necessarily portable across platforms.
- ">
- <Param name="···" />
- </Overload>
- </KeyWord>
- <KeyWord name="string.dump" func="yes">
- <Overload retVal="void" descr="
- Returns a string containing a binary representation of the given function, so that a later
- loadstring on this string returns a copy of the function. function must be a Lua function
- without upvalues.
- ">
- <Param name="function" />
- </Overload>
- </KeyWord>
- <KeyWord name="string.find" func="yes">
- <Overload retVal="void" descr="
- Looks for the first match of pattern in the string s. If it finds a match, then find returns
- the indices of s where this occurrence starts and ends; otherwise, it returns nil. A third,
- optional numerical argument init specifies where to start the search; its default value is 1
- and can be negative. A value of true as a fourth, optional argument plain turns off the
- pattern matching facilities, so the function does a plain 'find substring' operation, with
- no characters in pattern being considered 'magic'. Note that if plain is given, then init
- must be given as well.
- If the pattern has captures, then in a successful match the captured values are also returned,
- after the two indices.
- ">
- <Param name="s" />
- <Param name="pattern" />
- <Param name="[, init [, plain]]" />
- </Overload>
- </KeyWord>
- <KeyWord name="string.format" func="yes">
- <Overload retVal="void" descr="
- Returns a formatted version of its variable number of arguments following the description
- given in its first argument (which must be a string). The format string follows the same
- rules as the printf family of standard C functions. The only differences are that the options/modifiers
- *, l, L, n, p, and h are not supported and that there is an extra option, q. The q option formats
- a string in a form suitable to be safely read back by the Lua interpreter: the string is
- written between double quotes, and all double quotes, newlines, embedded zeros, and backslashes
- in the string are correctly escaped when written. For instance, the call
- string.format('%q', 'a string with ''quotes'' and \n new line')
- will produce the string:
- 'a string with \''quotes\'' and \
- new line'
- The options c, d, E, e, f, g, G, i, o, u, X, and x all expect a number as argument, whereas
- q and s expect a string.
- This function does not accept string values containing embedded zeros, except as arguments
- to the q option.
- ">
- <Param name="formatstring" />
- <Param name="···" />
- </Overload>
- </KeyWord>
- <KeyWord name="string.gmatch" func="yes">
- <Overload retVal="void" descr="
- Returns an iterator function that, each time it is called, returns the next captures from
- pattern over string s. If pattern specifies no captures, then the whole match is produced
- in each call.
- As an example, the following loop
- s = 'hello world from Lua'
- for w in string.gmatch(s, '%a+') do
- print(w)
- end
- will iterate over all the words from string s, printing one per line. The next example collects
- all pairs key=value from the given string into a table:
- t = {}
- s = 'from=world, to=Lua'
- for k, v in string.gmatch(s, '(%w+)=(%w+)') do
- t[k] = v
- end
- For this function, a '^' at the start of a pattern does not work as an anchor, as this would
- prevent the iteration.
- ">
- <Param name="s" />
- <Param name="pattern" />
- </Overload>
- </KeyWord>
- <KeyWord name="string.gsub" func="yes">
- <Overload retVal="void" descr="
- Returns a copy of s in which all (or the first n, if given) occurrences of the pattern have
- been replaced by a replacement string specified by repl, which can be a string, a table, or
- a function. gsub also returns, as its second value, the total number of matches that occurred.
- Look at the online documentation for this function.
- ">
- <Param name="s" />
- <Param name="pattern" />
- <Param name="repl" />
- <Param name="[, n]" />
- </Overload>
- </KeyWord>
- <KeyWord name="string.len" func="yes">
- <Overload retVal="void" descr="
- Receives a string and returns its length. The empty string '' has length 0. Embedded zeros are
- counted, so 'a\000bc\000' has length 5.
- ">
- <Param name="s" />
- </Overload>
- </KeyWord>
- <KeyWord name="string.lower" func="yes">
- <Overload retVal="void" descr="
- Receives a string and returns a copy of this string with all uppercase letters changed to
- lowercase. All other characters are left unchanged. The definition of what an uppercase
- letter is depends on the current locale.
- ">
- <Param name="s" />
- </Overload>
- </KeyWord>
- <KeyWord name="string.match" func="yes">
- <Overload retVal="void" descr="
- Looks for the first match of pattern in the string s. If it finds one, then match returns the
- captures from the pattern; otherwise it returns nil. If pattern specifies no captures, then
- the whole match is returned. A third, optional numerical argument init specifies where to
- start the search; its default value is 1 and can be negative.
- ">
- <Param name="s" />
- <Param name="pattern" />
- <Param name="[, init]" />
- </Overload>
- </KeyWord>
- <KeyWord name="string.rep" func="yes">
- <Overload retVal="void" descr="
- Returns a string that is the concatenation of n copies of the string s.
- ">
- <Param name="s" />
- <Param name="n" />
- </Overload>
- </KeyWord>
- <KeyWord name="string.reverse" func="yes">
- <Overload retVal="void" descr="
- Returns a string that is the string s reversed.
- ">
- <Param name="s" />
- </Overload>
- </KeyWord>
- <KeyWord name="string.sub" func="yes">
- <Overload retVal="void" descr="
- Returns the substring of s that starts at i and continues until j; i and j can be negative.
- If j is absent, then it is assumed to be equal to -1 (which is the same as the string length).
- In particular, the call string.sub(s,1,j) returns a prefix of s with length j, and string.sub(s, -i)
- returns a suffix of s with length i.
- ">
- <Param name="s" />
- <Param name="i" />
- <Param name="[, j]" />
- </Overload>
- </KeyWord>
- <KeyWord name="string.upper" func="yes">
- <Overload retVal="void" descr="
- Receives a string and returns a copy of this string with all lowercase letters changed to
- uppercase. All other characters are left unchanged. The definition of what a lowercase letter
- is depends on the current locale.
- ">
- <Param name="s" />
- </Overload>
- </KeyWord>
- <KeyWord name="table.concat" func="yes">
- <Overload retVal="void" descr="
- Given an array where all elements are strings or numbers, returns table[i]..sep..table[i+1] ··· sep..table[j].
- The default value for sep is the empty string, the default for i is 1, and the default for j is the length
- of the table. If i is greater than j, returns the empty string.
- ">
- <Param name="table" />
- <Param name="[, sep [, i [, j]]]" />
- </Overload>
- </KeyWord>
- <KeyWord name="table.insert" func="yes">
- <Overload retVal="void" descr="
- Inserts element value at position pos in table, shifting up other elements to open space,
- if necessary. The default value for pos is n+1, where n is the length of the table (see §2.5.5),
- so that a call table.insert(t,x) inserts x at the end of table t.
- ">
- <Param name="table" />
- <Param name="[pos,]" />
- <Param name="value" />
- </Overload>
- </KeyWord>
- <KeyWord name="table.maxn" func="yes">
- <Overload retVal="void" descr="
- Returns the largest positive numerical index of the given table, or zero if the table has no
- positive numerical indices. (To do its job this function does a linear traversal of the whole table.)
- ">
- <Param name="table" />
- </Overload>
- </KeyWord>
- <KeyWord name="table.remove" func="yes">
- <Overload retVal="void" descr="
- Removes from table the element at position pos, shifting down other elements to close the space,
- if necessary. Returns the value of the removed element. The default value for pos is n, where n
- is the length of the table, so that a call table.remove(t) removes the last element of table t.
- ">
- <Param name="table" />
- <Param name="[, pos]" />
- </Overload>
- </KeyWord>
- <KeyWord name="table.sort" func="yes">
- <Overload retVal="void" descr="
- Sorts table elements in a given order, in-place, from table[1] to table[n], where n is the length
- of the table. If comp is given, then it must be a function that receives two table elements, and
- returns true when the first is less than the second (so that not comp(a[i+1],a[i]) will be true
- after the sort). If comp is not given, then the standard Lua operator lessthan is used instead.
- The sort algorithm is not stable; that is, elements considered equal by the given order may have
- their relative positions changed by the sort.
- ">
- <Param name="table" />
- <Param name="[, comp]" />
- </Overload>
- </KeyWord>
- <KeyWord name="tonumber" func="yes">
- <Overload retVal="void" descr="
- Tries to convert its argument to a number. If the argument is already a number or a string
- convertible to a number, then tonumber returns this number; otherwise, it returns nil.
- An optional argument specifies the base to interpret the numeral. The base may be any integer
- between 2 and 36, inclusive. In bases above 10, the letter 'A' (in either upper or lower case)
- represents 10, 'B' represents 11, and so forth, with 'Z' representing 35. In base 10 (the default),
- the number can have a decimal part, as well as an optional exponent part (see §2.1). In other
- bases, only unsigned integers are accepted.
- ">
- <Param name="e" />
- <Param name="[, base]" />
- </Overload>
- </KeyWord>
- <KeyWord name="tostring" func="yes">
- <Overload retVal="void" descr="
- Receives an argument of any type and converts it to a string in a reasonable format. For complete
- control of how numbers are converted, use string.format.
- If the metatable of e has a '__tostring' field, then tostring calls the corresponding value with
- e as argument, and uses the result of the call as its result.
- ">
- <Param name="e" />
- </Overload>
- </KeyWord>
- <KeyWord name="type" func="yes">
- <Overload retVal="void" descr="
- Returns the type of its only argument, coded as a string. The possible results of this function
- are 'nil' (a string, not the value nil), 'number', 'string', 'boolean', 'table', 'function', 'thread', and 'userdata'.
- ">
- <Param name="v" />
- </Overload>
- </KeyWord>
- <KeyWord name="unpack" func="yes">
- <Overload retVal="void" descr="
- Returns the elements from the given table. This function is equivalent to
- return list[i], list[i+1], ···, list[j]
- except that the above code can be written only for a fixed number of elements. By default, i is 1 and
- j is the length of the list, as defined by the length operator (see §2.5.5).
- ">
- <Param name="list" />
- <Param name="[, i [, j]]" />
- </Overload>
- </KeyWord>
- <KeyWord name="xpcall" func="yes">
- <Overload retVal="void" descr="
- This function is similar to pcall, except that you can set a new error handler.
- xpcall calls function f in protected mode, using err as the error handler. Any error inside f is
- not propagated; instead, xpcall catches the error, calls the err function with the original error
- object, and returns a status code. Its first result is the status code (a boolean), which is true
- if the call succeeds without errors. In this case, xpcall also returns all results from the call,
- after this first result. In case of any error, xpcall returns false plus the result from err.
- ">
- <Param name="f" />
- <Param name="err" />
- </Overload>
- </KeyWord>
- <!-- Lua 5.2 standard library-->
- <KeyWord name="rawlen" func="yes">
- <Overload retVal="void" descr="
- Returns the length of the object v, which must be a table or a string, without invoking any metamethod.
- Returns an integer number.
- ">
- <Param name="v" />
- </Overload>
- </KeyWord>
- <KeyWord name="package.config" func="no" />
- <KeyWord name="package.searchers" func="no" />
- <KeyWord name="package.searchers" func="no" />
- <KeyWord name="table.pack" func="yes">
- <Overload retVal="void" descr="
- Returns a new table with all parameters stored into keys 1, 2, etc. and with a field 'n' with the total
- number of parameters. Note that the resulting table may not be a sequence.
- ">
- <Param name="..." />
- </Overload>
- </KeyWord>
- <KeyWord name="table.unpack" func="yes">
- <Overload retVal="void" descr="
- Returns the elements from the given table. This function is equivalent to
- return list[i], list[i+1], ···, list[j]
- By default, i is 1 and j is #list.
- ">
- <Param name="list" />
- <Param name="[, i [, j]]" />
- </Overload>
- </KeyWord>
-
- <KeyWord name="bit32.arshift" func="yes">
- <Overload retVal="void" descr="
- Returns the number x shifted disp bits to the right. The number disp may be any representable integer.
- Negative displacements shift to the left.
- This shift operation is what is called arithmetic shift. Vacant bits on the left are filled with copies
- of the higher bit of x; vacant bits on the right are filled with zeros. In particular, displacements with
- absolute values higher than 31 result in zero or 0xFFFFFFFF (all original bits are shifted out).
- ">
- <Param name="x" />
- <Param name="disp" />
- </Overload>
- </KeyWord>
- <KeyWord name="bit32.band" func="yes">
- <Overload retVal="void" descr="
- Returns the bitwise and of its operands.
- ">
- <Param name="..." />
- </Overload>
- </KeyWord>
- <KeyWord name="bit32.bnot" func="yes">
- <Overload retVal="void" descr="
- Returns the bitwise negation of x. For any integer x, the following identity holds:
- assert(bit32.bnot(x) == (-1 - x) % 2^32)
- ">
- <Param name="x" />
- </Overload>
- </KeyWord>
- <KeyWord name="bit32.bor" func="yes">
- <Overload retVal="void" descr="
- Returns the bitwise or of its operands.
- ">
- <Param name="..." />
- </Overload>
- </KeyWord>
- <KeyWord name="bit32.btest" func="yes">
- <Overload retVal="void" descr="
- Returns a boolean signaling whether the bitwise and of its operands is different from zero.
- ">
- <Param name="..." />
- </Overload>
- </KeyWord>
- <KeyWord name="bit32.bxor" func="yes">
- <Overload retVal="void" descr="
- Returns the bitwise exclusive or of its operands.
- ">
- <Param name="..." />
- </Overload>
- </KeyWord>
- <KeyWord name="bit32.extract" func="yes">
- <Overload retVal="void" descr="
- Returns the unsigned number formed by the bits field to field + width - 1 from n.
- Bits are numbered from 0 (least significant) to 31 (most significant).
- All accessed bits must be in the range [0, 31].
- The default for width is 1.
- ">
- <Param name="n" />
- <Param name="[, width]" />
- </Overload>
- </KeyWord>
- <KeyWord name="bit32.replace" func="yes">
- <Overload retVal="void" descr="
- Returns a copy of n with the bits field to field + width - 1 replaced by the value v.
- See bit32.extract for details about field and width.
- ">
- <Param name="n" />
- <Param name="v" />
- <Param name="[, width]" />
- </Overload>
- </KeyWord>
- <KeyWord name="bit32.lrotate" func="yes">
- <Overload retVal="void" descr="
- Returns the number x rotated disp bits to the left. The number disp may be any representable integer.
- For any valid displacement, the following identity holds:
- assert(bit32.lrotate(x, disp) == bit32.lrotate(x, disp % 32))
- In particular, negative displacements rotate to the right.
- ">
- <Param name="x" />
- <Param name="disp" />
- </Overload>
- </KeyWord>
- <KeyWord name="bit32.lshift" func="yes">
- <Overload retVal="void" descr="
- Returns the number x shifted disp bits to the left. The number disp may be any representable integer.
- Negative displacements shift to the right. In any direction, vacant bits are filled with zeros.
- In particular, displacements with absolute values higher than 31 result in zero (all bits are shifted out).
- For positive displacements, the following equality holds:
- assert(bit32.lshift(b, disp) == (b * 2^disp) % 2^32)
- ">
- <Param name="x" />
- <Param name="disp" />
- </Overload>
- </KeyWord>
- <KeyWord name="bit32.rrotate" func="yes">
- <Overload retVal="void" descr="
- Returns the number x rotated disp bits to the right. The number disp may be any representable integer.
- For any valid displacement, the following identity holds:
- assert(bit32.rrotate(x, disp) == bit32.rrotate(x, disp % 32))
- In particular, negative displacements rotate to the left.
- ">
- <Param name="x" />
- <Param name="disp" />
- </Overload>
- </KeyWord>
- <KeyWord name="bit32.rshift" func="yes">
- <Overload retVal="void" descr="
- Returns the number x shifted disp bits to the right. The number disp may be any representable integer.
- Negative displacements shift to the left. In any direction, vacant bits are filled with zeros.
- In particular, displacements with absolute values higher than 31 result in zero (all bits are shifted out).
- For positive displacements, the following equality holds:
- assert(bit32.rshift(b, disp) == math.floor(b % 2^32 / 2^disp))
- This shift operation is what is called logical shift.
- ">
- <Param name="x" />
- <Param name="disp" />
- </Overload>
- </KeyWord>
- <KeyWord name="debug.getuservalue" func="yes">
- <Overload retVal="void" descr="
- Returns the Lua value associated to u. If u is not a userdata, returns nil.
- ">
- <Param name="u" />
- </Overload>
- </KeyWord>
- <KeyWord name="debug.setuservalue" func="yes">
- <Overload retVal="void" descr="
- Sets the given value as the Lua value associated to the given udata. value must be a table or nil;
- udata must be a full userdata.
- Returns udata.
- ">
- <Param name="udata" />
- <Param name="value" />
- </Overload>
- </KeyWord>
- <KeyWord name="debug.upvalueid" func="yes">
- <Overload retVal="void" descr="
- Returns an unique identifier (as a light userdata) for the upvalue numbered n from the given function.
- These unique identifiers allow a program to check whether different closures share upvalues.
- Lua closures that share an upvalue (that is, that access a same external local variable) will return
- identical ids for those upvalue indices.
- ">
- <Param name="f" />
- <Param name="n" />
- </Overload>
- </KeyWord>
- <KeyWord name="debug.upvaluejoin" func="yes">
- <Overload retVal="void" descr="
- Make the n1-th upvalue of the Lua closure f1 refer to the n2-th upvalue of the Lua closure f2.
- ">
- <Param name="f1" />
- <Param name="n1" />
- <Param name="f2" />
- <Param name="n2" />
- </Overload>
- </KeyWord>
- <!-- Lua 5.3 standard library-->
- <KeyWord name="coroutine.isyieldable" func="yes">
- <Overload retVal="void" descr="
- Returns true when the running coroutine can yield.
- A running coroutine is yieldable if it is not the main thread and it is not inside a non-yieldable C function.
- ">
- </Overload>
- </KeyWord>
- <KeyWord name="package.searchpath" func="yes">
- <Overload retVal="void" descr="
- Searches for the given name in the given path.
- A path is a string containing a sequence of templates separated by semicolons. For each template,
- the function replaces each interrogation mark (if any) in the template with a copy of name wherein
- all occurrences of sep (a dot, by default) were replaced by rep (the system's directory separator, by default),
- and then tries to open the resulting file name.
- For instance, if the path is the string
- './?.lua;./?.lc;/usr/local/?/init.lua'
- the search for the name foo.a will try to open the files ./foo/a.lua, ./foo/a.lc, and /usr/local/foo/a/init.lua,
- in that order.
- Returns the resulting name of the first file that it can open in read mode (after closing the file),
- or nil plus an error message if none succeeds. (This error message lists all file names it tried to open.)
- ">
- <Param name="name" />
- <Param name="path [, sep [, rep]]" />
- </Overload>
- </KeyWord>
- <KeyWord name="string.pack" func="yes">
- <Overload retVal="void" descr="
- Returns a binary string containing the values v1, v2, etc. packed (that is, serialized in binary form) according
- to the format string fmt (see §6.4.2).
- string.packsize (fmt)
- ">
- <Param name="fmt" />
- <Param name="v1" />
- <Param name="v2" />
- <Param name="..." />
- </Overload>
- </KeyWord>
- <KeyWord name="string.packsize" func="yes">
- <Overload retVal="void" descr="
- Returns the size of a string resulting from string.pack with the given format. The format string cannot have the
- variable-length options 's' or 'z' (see §6.4.2).
- ">
- <Param name="fmt" />
- </Overload>
- </KeyWord>
- <KeyWord name="string.unpack" func="yes">
- <Overload retVal="void" descr="
- Returns the values packed in string s (see string.pack) according to the format string fmt (see §6.4.2).
- An optional pos marks where to start reading in s (default is 1). After the read values, this function also
- returns the index of the first unread byte in s.
- ">
- <Param name="fmt" />
- <Param name="s [, pos]" />
- </Overload>
- </KeyWord>
- <KeyWord name="utf8.char" func="yes">
- <Overload retVal="void" descr="
- Receives zero or more integers, converts each one to its corresponding UTF-8 byte sequence and returns a
- string with the concatenation of all these sequences.
- ">
- <Param name="..." />
- </Overload>
- </KeyWord>
- <KeyWord name="utf8.charpattern" func="no" />
- <KeyWord name="utf8.codes" func="yes">
- <Overload retVal="void" descr="
- Returns values so that the construction
- for p, c in utf8.codes(s) do body end
- will iterate over all characters in string s, with p being the position (in bytes) and c the code point of
- each character. It raises an error if it meets any invalid byte sequence.
- ">
- <Param name="s" />
- </Overload>
- </KeyWord>
- <KeyWord name="utf8.codepoint" func="yes">
- <Overload retVal="void" descr="
- Returns the codepoints (as integers) from all characters in s that start between byte position i and j (both included).
- The default for i is 1 and for j is i. It raises an error if it meets any invalid byte sequence.
- ">
- <Param name="s" />
- <Param name="[, i [, j]]" />
- </Overload>
- </KeyWord>
- <KeyWord name="utf8.len" func="yes">
- <Overload retVal="void" descr="
- Returns the number of UTF-8 characters in string s that start between positions i and j (both inclusive).
- The default for i is 1 and for j is -1. If it finds any invalid byte sequence, returns a false value plus the
- position of the first invalid byte.
- ">
- <Param name="s" />
- <Param name="[, i [, j]]" />
- </Overload>
- </KeyWord>
- <KeyWord name="utf8.offset" func="yes">
- <Overload retVal="void" descr="
- Returns the position (in bytes) where the encoding of the n-th character of s (counting from position i) starts.
- A negative n gets characters before position i. The default for i is 1 when n is non-negative and #s + 1 otherwise,
- so that utf8.offset(s, -n) gets the offset of the n-th character from the end of the string. If the specified character
- is neither in the subject nor right after its end, the function returns nil.
- As a special case, when n is 0 the function returns the start of the encoding of the character that contains the i-th byte of s.
- This function assumes that s is a valid UTF-8 string.
- ">
- <Param name="s" />
- <Param name="n [, i]" />
- </Overload>
- </KeyWord>
- <KeyWord name="table.move" func="yes">
- <Overload retVal="void" descr="
- Moves elements from table a1 to table a2, performing the equivalent to the following multiple assignment: a2[t],··· = a1[f],···,a1[e].
- The default for a2 is a1. The destination range can overlap with the source range. The number of elements to be moved must fit in a Lua integer.
- Returns the destination table a2.
- ">
- <Param name="a1" />
- <Param name="f" />
- <Param name="e" />
- <Param name="t [,a2]" />
- </Overload>
- </KeyWord>
- <KeyWord name="math.maxinteger" func="no" />
- <KeyWord name="math.mininteger" func="no" />
- <KeyWord name="math.tointeger" func="yes">
- <Overload retVal="void" descr="
- If the value x is convertible to an integer, returns that integer. Otherwise, returns nil.
- ">
- <Param name="x" />
- </Overload>
- </KeyWord>
- <KeyWord name="math.type" func="yes">
- <Overload retVal="void" descr="
- Returns 'integer' if x is an integer, 'float' if it is a float, or nil if x is not a number.
- ">
- <Param name="x" />
- </Overload>
- </KeyWord>
- <KeyWord name="math.ult" func="yes">
- <Overload retVal="void" descr="
- Returns a boolean, true if and only if integer m is below integer n when they are compared as unsigned integers.
- ">
- <Param name="m" />
- <Param name="n" />
- </Overload>
- </KeyWord>
- <!-- Lua 5.4 standard library-->
- <KeyWord name="warn" func="yes">
- <Overload retVal="void" descr="
- Emits a warning with a message composed by the concatenation of all its arguments (which should be strings).
- By convention, a one-piece message starting with '@' is intended to be a control message, which is a message
- to the warning system itself. In particular, the standard warning function in Lua recognizes the control messages '@off',
- to stop the emission of warnings, and '@on', to (re)start the emission; it ignores unknown control messages.
- ">
- <Param name="msg1" />
- <Param name="..." />
- </Overload>
- </KeyWord>
- <KeyWord name="coroutine.close" func="yes">
- <Overload retVal="void" descr="
- Closes coroutine co, that is, closes all its pending to-be-closed variables and puts the coroutine in a dead state.
- The given coroutine must be dead or suspended. In case of error (either the original error that stopped the coroutine
- or errors in closing methods), returns false plus the error object; otherwise returns true.
- ">
- <Param name="co" />
- </Overload>
- </KeyWord>
- </AutoComplete>
- </NotepadPlus>
|