diff options
Diffstat (limited to 'doc/context/sources/general/manuals/luatex/luatex-lua.tex')
-rw-r--r-- | doc/context/sources/general/manuals/luatex/luatex-lua.tex | 118 |
1 files changed, 114 insertions, 4 deletions
diff --git a/doc/context/sources/general/manuals/luatex/luatex-lua.tex b/doc/context/sources/general/manuals/luatex/luatex-lua.tex index f4d0c770c..bc06596db 100644 --- a/doc/context/sources/general/manuals/luatex/luatex-lua.tex +++ b/doc/context/sources/general/manuals/luatex/luatex-lua.tex @@ -345,7 +345,17 @@ returns the name. \stopsubsection -\startsubsection[title={Multibyte \type {string} functions}] +\startsubsection[title={Multibyte \type {string} functions}][library=string] + +\libindex{utfvalues} +\libindex{utfcharacters} +\libindex{characters} +\libindex{characterpairs} +\libindex{bytes} +\libindex{bytepairs} +\libindex{utfvalue} +\libindex{utfcharacter} +\libindex{utflength} The \type {string} library has a few extra functions like \type {string.explode(s[,m])}. This function returns an array containing the string @@ -369,7 +379,7 @@ piecemeal: \type {string.utfcharacters(s)}: a string with a single \UTF-8 token in it \stopitem \startitem - \type {string.characters(s)}: a string containing one byte + \type {string.cWharacters(s)}: a string containing one byte \stopitem \startitem \type {string.characterpairs(s)}: two strings each containing one byte or an @@ -427,7 +437,19 @@ as building blocks for other helpers. So, eventually we can decide to drop the \stopsubsection -\startsubsection[title={Extra \type {os} library functions}] +\startsubsection[title={Extra \type {os} library functions}][library=os] + +\libindex{selfdir} +\libindex{exec} +\libindex{spawn} +\libindex{setenv} +\libindex{env} +\libindex{gettimeofday} +\libindex{times} +\libindex{tmpdir} +\libindex{type} +\libindex{name} +\libindex{uname} The \type {os} library has a few extra functions and variables: @@ -551,7 +573,7 @@ The \type {os} library has a few extra functions and variables: \stopitem \startitem - \type {os.uname()} returns a table with specific operating system + \type {os.uname} returns a table with specific operating system information acquired at runtime. The keys in the returned table are all string values, and their names are: \type {sysname}, \type {machine}, \type {release}, \type {version}, and \type {nodename}. @@ -561,6 +583,94 @@ The \type {os} library has a few extra functions and variables: \stopsubsection +\startsubsection[title={Binary input from files with \type {fio}}][library=fio] + +\libindex{readcardinal1} +\libindex{readcardinal2} +\libindex{readcardinal3} +\libindex{readcardinal4} +\libindex{readcardinaltable} +\libindex{readinteger1} +\libindex{readinteger2} +\libindex{readinteger3} +\libindex{readinteger4} +\libindex{readintegertable} +\libindex{readfixed2} +\libindex{readfixed4} +\libindex{read2dot14} +\libindex{setposition} +\libindex{getposition} +\libindex{skipposition} +\libindex{readbytes} +\libindex{readbytetable} +%libindex{readline} +%libindex{recordfilename} +%libindex{checkpermission} + +This library provides a set of functions for reading numbers from a file and +in addition to the regular \type {io} library functions. + +\starttabulate +\NC \type{readcardinal1(f)} \NC a 1 byte unsigned integer \NC \NR +\NC \type{readcardinal2(f)} \NC a 2 byte unsigned integer \NC \NR +\NC \type{readcardinal3(f)} \NC a 3 byte unsigned integer \NC \NR +\NC \type{readcardinal4(f)} \NC a 4 byte unsigned integer \NC \NR +\NC \type{readcardinaltable(f,n,b)} \NC \type {n} cardinals of \type {b} bytes \NC \NR +\NC \type{readinteger1(f)} \NC a 1 byte signed integer \NC \NR +\NC \type{readinteger2(f)} \NC a 2 byte signed integer \NC \NR +\NC \type{readinteger3(f)} \NC a 3 byte signed integer \NC \NR +\NC \type{readinteger4(f)} \NC a 4 byte signed integer \NC \NR +\NC \type{readintegertable(f,n,b)} \NC \type {n} integers of \type {b} bytes \NC \NR +\NC \type{readfixed2(f)} \NC a 2 byte float (used in font files) \NC \NR +\NC \type{readfixed4(f)} \NC a 4 byte float (used in font files) \NC \NR +\NC \type{read2dot14(f)} \NC a 2 byte float (used in font files) \NC \NR +\NC \type{setposition(f,p)} \NC goto position \type {p} \NC \NR +\NC \type{getposition(f)} \NC get the current position \NC \NR +\NC \type{skipposition(f,n)} \NC skip \type {n} positions \NC \NR +\NC \type{readbytes(f,n)} \NC \type {n} bytes \NC \NR +\NC \type{readbytetable(f,n)} \NC \type {n} bytes\NC \NR +\stoptabulate + +\stopsubsection + +\startsubsection[title={Binary input from strings with \type {sio}}][library=sio] + +\libindex{readcardinal1} +\libindex{readcardinal2} +\libindex{readcardinal3} +\libindex{readcardinal4} +\libindex{readcardinaltable} +\libindex{readinteger1} +\libindex{readinteger2} +\libindex{readinteger3} +\libindex{readinteger4} +\libindex{readintegertable} +\libindex{readfixed2} +\libindex{readfixed4} +\libindex{read2dot14} +\libindex{setposition} +\libindex{getposition} +\libindex{skipposition} +\libindex{readbytes} +\libindex{readbytetable} + +A similar set of function as in the \type {fio} library is available in the \type +{sio} library. Here the first argument is a string. + +\stopsubsection + +\startsubsection[title={Hashes conform \type {sha2}}][library=sha2] + +\libindex{digest256} +\libindex{digest384} +\libindex{digest512} + +This library is a side effect of the \type {pdfe} library that needs such +helpers. The \type {digest256}, \type {digest384} and \type {digest512} functions +accept a string and return a string with the hash. + +\stopsubsection + \startsubsection[title={Locales}] In stock \LUA, many things depend on the current locale. In \LUATEX, we can't do |