doc/src/snippets/sqldatabase/sqldatabase.cpp


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

'\"
'\" Copyright (c) 1989-1993 The Regents of the University of California.
'\" Copyright (c) 1994-1996 Sun Microsystems, Inc.
'\"
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\" 
.so man.macros
.TH Tcl_AllowExceptions 3 7.4 Tcl "Tcl Library Procedures"
.BS
.SH NAME
Tcl_AllowExceptions \- allow all exceptions in next script evaluation
.SH SYNOPSIS
.nf
\fB#include <tcl.h>\fR
.sp
\fBTcl_AllowExceptions\fR(\fIinterp\fR)
.SH ARGUMENTS
.AS Tcl_Interp *interp
.AP Tcl_Interp *interp in
Interpreter in which script will be evaluated.
.BE

.SH DESCRIPTION
.PP
If a script is evaluated at top-level (i.e. no other scripts are
pending evaluation when the script is invoked), and if the script
terminates with a completion code other than \fBTCL_OK\fR, \fBTCL_ERROR\fR
or \fBTCL_RETURN\fR, then Tcl normally converts this into a \fBTCL_ERROR\fR
return with an appropriate message.  The particular script
evaluation procedures of Tcl that act in the manner are
\fBTcl_EvalObjEx\fR, \fBTcl_EvalObjv\fR, \fBTcl_Eval\fR, \fBTcl_EvalEx\fR,
\fBTcl_GlobalEval\fR, \fBTcl_GlobalEvalObj\fR, \fBTcl_VarEval\fR and
\fBTcl_VarEvalVA\fR. 
.PP
However, if \fBTcl_AllowExceptions\fR is invoked immediately before
calling one of those a procedures, then arbitrary completion
codes are permitted from the script, and they are returned without
modification.
This is useful in cases where the caller can deal with exceptions
such as \fBTCL_BREAK\fR or \fBTCL_CONTINUE\fR in a meaningful way.

.SH KEYWORDS
continue, break, exception, interpreter
	Commit message (Collapse)	Author	Age	Files	Lines
*	Doc: Made a number of fixes to the documentation.	David Boddie	2010-10-04	1	-1/+1
\|
*	Doc: Updated example license to three clause BSD license.	David Boddie	2010-06-10	1	-27/+26
\| \| \| \| \| \| \|	See change 8f47373e3795d7ec50387d5f1a771a59567bdaea for context. Reviewed-by: Trust Me Requested-by: Legal
*	Update copyright year to 2010	Jason McDonald	2010-01-06	1	-1/+1
\| \| \| \|	Reviewed-by: Trust Me
*	Update license headers again.	Jason McDonald	2009-09-09	1	-4/+4
\| \| \| \|	Reviewed-by: Trust Me
*	Update tech preview license header.	Jason McDonald	2009-08-31	1	-13/+13
\| \| \| \|	Reviewed-by: Trust Me
*	Update license headers.	Jason McDonald	2009-08-11	1	-1/+1
\| \| \| \|	Reviewed-by: Trust Me
*	Update license headers as requested by the marketing department.	Jason McDonald	2009-06-16	1	-2/+2
\| \| \| \|	Reviewed-by: Trust Me
*	Correcting bug in custom Database Driver code snipptet	Morten Engvoldsen	2009-05-11	1	-1/+1
\| \| \| \| \| \| \|	Adding const to call. Changing QSqlRecord record() { return QSqlRecord(); } to QSqlRecord record() const { return QSqlRecord(); } This is needed since record() is a virtual function. Task-number:204557 Rev-by: Geir Vattekar
*	Long live Qt 4.5!	Lars Knoll	2009-03-23	1	-0/+560