mirror of
https://github.com/lua/lua.git
synced 2025-01-28 06:03:00 +08:00
no more "lua_Reference"; new return value for "append";
documentation of "exit" (it was not in the manual).
This commit is contained in:
parent
bced00ab9e
commit
4fb77c4308
39
manual.tex
39
manual.tex
@ -1,4 +1,4 @@
|
||||
% $Id: manual.tex,v 1.15 1996/04/01 14:36:35 roberto Exp roberto $
|
||||
% $Id: manual.tex,v 1.16 1996/04/22 18:00:37 roberto Exp roberto $
|
||||
|
||||
\documentstyle[fullpage,11pt,bnf]{article}
|
||||
|
||||
@ -34,7 +34,7 @@ Waldemar Celes Filho
|
||||
\tecgraf\ --- Departamento de Inform\'atica --- PUC-Rio
|
||||
}
|
||||
|
||||
\date{\small \verb$Date: 1996/04/01 14:36:35 $}
|
||||
\date{\small \verb$Date: 1996/04/22 18:00:37 $}
|
||||
|
||||
\maketitle
|
||||
|
||||
@ -1079,12 +1079,10 @@ The routines to manipulate references are the following:
|
||||
\Deffunc{lua_ref}\Deffunc{lua_getref}
|
||||
\Deffunc{lua_pushref}\Deffunc{lua_unref}
|
||||
\begin{verbatim}
|
||||
typedef int lua_Reference;
|
||||
|
||||
lua_Reference lua_ref (int lock);
|
||||
lua_Object lua_getref (lua_Reference ref);
|
||||
void lua_pushref (lua_Reference ref);
|
||||
void lua_unref (lua_Reference ref);
|
||||
int lua_ref (int lock);
|
||||
lua_Object lua_getref (int ref);
|
||||
void lua_pushref (int ref);
|
||||
void lua_unref (int ref);
|
||||
\end{verbatim}
|
||||
The function \verb'lua_ref' creates a reference
|
||||
to the object which is on the top of the stack,
|
||||
@ -1122,7 +1120,7 @@ Currently there are three standard libraries:
|
||||
\begin{itemize}
|
||||
\item string manipulation;
|
||||
\item mathematical functions (sin, cos, etc);
|
||||
\item input and output.
|
||||
\item input and output (plus some system facilities).
|
||||
\end{itemize}
|
||||
In order to have access to these libraries,
|
||||
the host program must call the functions
|
||||
@ -1382,8 +1380,6 @@ This function opens a file named \verb'filename' and sets it as the
|
||||
{\em current} output file.
|
||||
Unlike the \verb'writeto' operation,
|
||||
this function does not erase any previous content of the file.
|
||||
This function returns 2 if the file already exists,
|
||||
1 if it creates a new file, and \nil\ on failure.
|
||||
|
||||
\subsubsection*{{\tt remove (filename)}}\Deffunc{remove}
|
||||
|
||||
@ -1484,15 +1480,11 @@ it returns a reasonable date and time representation.
|
||||
This function replaces functions \verb'date' and \verb'time' from
|
||||
previous Lua versions.
|
||||
|
||||
\subsubsection*{{\tt exit ([code])}}\Deffunc{exit}
|
||||
|
||||
% \subsubsection*{{\tt debug ()}}
|
||||
% This function, when called, repeatedly presents a prompt \verb'lua_debug> '
|
||||
% in the error output stream (\verb'stderr'),
|
||||
% reads a line from the standard input,
|
||||
% and executes (``dostring'') the line.
|
||||
% The loop ends when the user types \verb'cont' to the prompt.
|
||||
% This function then returns and the execution of the program continues.
|
||||
|
||||
This function calls the C function \verb-exit-,
|
||||
with an optional \verb-code-,
|
||||
to terminate the program.
|
||||
|
||||
|
||||
\section{The Debuger Interface} \label{debugI}
|
||||
@ -1850,8 +1842,8 @@ as illustrated in Figure~\ref{Cinher}.
|
||||
\begin{verbatim}
|
||||
#include "lua.h"
|
||||
|
||||
lua_Reference lockedParentName; /* lock index for the string "parent" */
|
||||
lua_Reference lockedOldIndex; /* previous fallback function */
|
||||
int lockedParentName; /* lock index for the string "parent" */
|
||||
int lockedOldIndex; /* previous fallback function */
|
||||
|
||||
void callOldFallback (lua_Object table, lua_Object index)
|
||||
{
|
||||
@ -2090,10 +2082,13 @@ Here is a list of all these differences.
|
||||
Functions \verb'date' and \verb'time' (from \verb'iolib')
|
||||
have been superseded by the new version of function \verb'date'.
|
||||
\item
|
||||
Function \verb'append' (from \verb'iolib') now returns 1 whenever it succeeds,
|
||||
whether the file is new or not.
|
||||
\item
|
||||
Function \verb'int2str' (from \verb'strlib') has been superseded by new
|
||||
function \verb'format', with parameter \verb'"%c"'.
|
||||
\item
|
||||
The lock mechanism has been superseded by the reference mechanism.
|
||||
The API lock mechanism has been superseded by the reference mechanism.
|
||||
However, \verb-lua.h- provides compatibility macros,
|
||||
so there is no need to change programs.
|
||||
\item
|
||||
|
Loading…
x
Reference in New Issue
Block a user