1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/os/persistentdata/persistentstorage/sql/SQLite/tokenize.c Fri Jun 15 03:10:57 2012 +0200
1.3 @@ -0,0 +1,508 @@
1.4 +/*
1.5 +** 2001 September 15
1.6 +**
1.7 +** The author disclaims copyright to this source code. In place of
1.8 +** a legal notice, here is a blessing:
1.9 +**
1.10 +** May you do good and not evil.
1.11 +** May you find forgiveness for yourself and forgive others.
1.12 +** May you share freely, never taking more than you give.
1.13 +**
1.14 +*************************************************************************
1.15 +** An tokenizer for SQL
1.16 +**
1.17 +** This file contains C code that splits an SQL input string up into
1.18 +** individual tokens and sends those tokens one-by-one over to the
1.19 +** parser for analysis.
1.20 +**
1.21 +** $Id: tokenize.c,v 1.148 2008/07/28 19:34:54 drh Exp $
1.22 +*/
1.23 +#include "sqliteInt.h"
1.24 +#include <ctype.h>
1.25 +#include <stdlib.h>
1.26 +
1.27 +/*
1.28 +** The charMap() macro maps alphabetic characters into their
1.29 +** lower-case ASCII equivalent. On ASCII machines, this is just
1.30 +** an upper-to-lower case map. On EBCDIC machines we also need
1.31 +** to adjust the encoding. Only alphabetic characters and underscores
1.32 +** need to be translated.
1.33 +*/
1.34 +#ifdef SQLITE_ASCII
1.35 +# define charMap(X) sqlite3UpperToLower[(unsigned char)X]
1.36 +#endif
1.37 +#ifdef SQLITE_EBCDIC
1.38 +# define charMap(X) ebcdicToAscii[(unsigned char)X]
1.39 +const unsigned char ebcdicToAscii[] = {
1.40 +/* 0 1 2 3 4 5 6 7 8 9 A B C D E F */
1.41 + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, /* 0x */
1.42 + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, /* 1x */
1.43 + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, /* 2x */
1.44 + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, /* 3x */
1.45 + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, /* 4x */
1.46 + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, /* 5x */
1.47 + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 95, 0, 0, /* 6x */
1.48 + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, /* 7x */
1.49 + 0, 97, 98, 99,100,101,102,103,104,105, 0, 0, 0, 0, 0, 0, /* 8x */
1.50 + 0,106,107,108,109,110,111,112,113,114, 0, 0, 0, 0, 0, 0, /* 9x */
1.51 + 0, 0,115,116,117,118,119,120,121,122, 0, 0, 0, 0, 0, 0, /* Ax */
1.52 + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, /* Bx */
1.53 + 0, 97, 98, 99,100,101,102,103,104,105, 0, 0, 0, 0, 0, 0, /* Cx */
1.54 + 0,106,107,108,109,110,111,112,113,114, 0, 0, 0, 0, 0, 0, /* Dx */
1.55 + 0, 0,115,116,117,118,119,120,121,122, 0, 0, 0, 0, 0, 0, /* Ex */
1.56 + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, /* Fx */
1.57 +};
1.58 +#endif
1.59 +
1.60 +/*
1.61 +** The sqlite3KeywordCode function looks up an identifier to determine if
1.62 +** it is a keyword. If it is a keyword, the token code of that keyword is
1.63 +** returned. If the input is not a keyword, TK_ID is returned.
1.64 +**
1.65 +** The implementation of this routine was generated by a program,
1.66 +** mkkeywordhash.h, located in the tool subdirectory of the distribution.
1.67 +** The output of the mkkeywordhash.c program is written into a file
1.68 +** named keywordhash.h and then included into this source file by
1.69 +** the #include below.
1.70 +*/
1.71 +#include "keywordhash.h"
1.72 +
1.73 +
1.74 +/*
1.75 +** If X is a character that can be used in an identifier then
1.76 +** IdChar(X) will be true. Otherwise it is false.
1.77 +**
1.78 +** For ASCII, any character with the high-order bit set is
1.79 +** allowed in an identifier. For 7-bit characters,
1.80 +** sqlite3IsIdChar[X] must be 1.
1.81 +**
1.82 +** For EBCDIC, the rules are more complex but have the same
1.83 +** end result.
1.84 +**
1.85 +** Ticket #1066. the SQL standard does not allow '$' in the
1.86 +** middle of identfiers. But many SQL implementations do.
1.87 +** SQLite will allow '$' in identifiers for compatibility.
1.88 +** But the feature is undocumented.
1.89 +*/
1.90 +#ifdef SQLITE_ASCII
1.91 +const char sqlite3IsAsciiIdChar[] = {
1.92 +/* x0 x1 x2 x3 x4 x5 x6 x7 x8 x9 xA xB xC xD xE xF */
1.93 + 0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, /* 2x */
1.94 + 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0, 0, 0, /* 3x */
1.95 + 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, /* 4x */
1.96 + 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0, 1, /* 5x */
1.97 + 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, /* 6x */
1.98 + 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0, 0, /* 7x */
1.99 +};
1.100 +#define IdChar(C) (((c=C)&0x80)!=0 || (c>0x1f && sqlite3IsAsciiIdChar[c-0x20]))
1.101 +#endif
1.102 +#ifdef SQLITE_EBCDIC
1.103 +const char sqlite3IsEbcdicIdChar[] = {
1.104 +/* x0 x1 x2 x3 x4 x5 x6 x7 x8 x9 xA xB xC xD xE xF */
1.105 + 0, 0, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0, 0, 0, /* 4x */
1.106 + 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 1, 0, 0, 0, 0, /* 5x */
1.107 + 0, 0, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 1, 0, 0, /* 6x */
1.108 + 0, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0, 0, 0, 0, /* 7x */
1.109 + 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 1, 1, 1, 0, /* 8x */
1.110 + 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 1, 0, 1, 0, /* 9x */
1.111 + 1, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 1, 1, 1, 0, /* Ax */
1.112 + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, /* Bx */
1.113 + 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 1, 1, 1, 1, 1, /* Cx */
1.114 + 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 1, 1, 1, 1, 1, /* Dx */
1.115 + 0, 0, 1, 1, 1, 1, 1, 1, 1, 1, 0, 1, 1, 1, 1, 1, /* Ex */
1.116 + 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 1, 1, 1, 1, 0, /* Fx */
1.117 +};
1.118 +#define IdChar(C) (((c=C)>=0x42 && sqlite3IsEbcdicIdChar[c-0x40]))
1.119 +#endif
1.120 +
1.121 +
1.122 +/*
1.123 +** Return the length of the token that begins at z[0].
1.124 +** Store the token type in *tokenType before returning.
1.125 +*/
1.126 +int sqlite3GetToken(const unsigned char *z, int *tokenType){
1.127 + int i, c;
1.128 + switch( *z ){
1.129 + case ' ': case '\t': case '\n': case '\f': case '\r': {
1.130 + for(i=1; isspace(z[i]); i++){}
1.131 + *tokenType = TK_SPACE;
1.132 + return i;
1.133 + }
1.134 + case '-': {
1.135 + if( z[1]=='-' ){
1.136 + for(i=2; (c=z[i])!=0 && c!='\n'; i++){}
1.137 + *tokenType = TK_COMMENT;
1.138 + return i;
1.139 + }
1.140 + *tokenType = TK_MINUS;
1.141 + return 1;
1.142 + }
1.143 + case '(': {
1.144 + *tokenType = TK_LP;
1.145 + return 1;
1.146 + }
1.147 + case ')': {
1.148 + *tokenType = TK_RP;
1.149 + return 1;
1.150 + }
1.151 + case ';': {
1.152 + *tokenType = TK_SEMI;
1.153 + return 1;
1.154 + }
1.155 + case '+': {
1.156 + *tokenType = TK_PLUS;
1.157 + return 1;
1.158 + }
1.159 + case '*': {
1.160 + *tokenType = TK_STAR;
1.161 + return 1;
1.162 + }
1.163 + case '/': {
1.164 + if( z[1]!='*' || z[2]==0 ){
1.165 + *tokenType = TK_SLASH;
1.166 + return 1;
1.167 + }
1.168 + for(i=3, c=z[2]; (c!='*' || z[i]!='/') && (c=z[i])!=0; i++){}
1.169 + if( c ) i++;
1.170 + *tokenType = TK_COMMENT;
1.171 + return i;
1.172 + }
1.173 + case '%': {
1.174 + *tokenType = TK_REM;
1.175 + return 1;
1.176 + }
1.177 + case '=': {
1.178 + *tokenType = TK_EQ;
1.179 + return 1 + (z[1]=='=');
1.180 + }
1.181 + case '<': {
1.182 + if( (c=z[1])=='=' ){
1.183 + *tokenType = TK_LE;
1.184 + return 2;
1.185 + }else if( c=='>' ){
1.186 + *tokenType = TK_NE;
1.187 + return 2;
1.188 + }else if( c=='<' ){
1.189 + *tokenType = TK_LSHIFT;
1.190 + return 2;
1.191 + }else{
1.192 + *tokenType = TK_LT;
1.193 + return 1;
1.194 + }
1.195 + }
1.196 + case '>': {
1.197 + if( (c=z[1])=='=' ){
1.198 + *tokenType = TK_GE;
1.199 + return 2;
1.200 + }else if( c=='>' ){
1.201 + *tokenType = TK_RSHIFT;
1.202 + return 2;
1.203 + }else{
1.204 + *tokenType = TK_GT;
1.205 + return 1;
1.206 + }
1.207 + }
1.208 + case '!': {
1.209 + if( z[1]!='=' ){
1.210 + *tokenType = TK_ILLEGAL;
1.211 + return 2;
1.212 + }else{
1.213 + *tokenType = TK_NE;
1.214 + return 2;
1.215 + }
1.216 + }
1.217 + case '|': {
1.218 + if( z[1]!='|' ){
1.219 + *tokenType = TK_BITOR;
1.220 + return 1;
1.221 + }else{
1.222 + *tokenType = TK_CONCAT;
1.223 + return 2;
1.224 + }
1.225 + }
1.226 + case ',': {
1.227 + *tokenType = TK_COMMA;
1.228 + return 1;
1.229 + }
1.230 + case '&': {
1.231 + *tokenType = TK_BITAND;
1.232 + return 1;
1.233 + }
1.234 + case '~': {
1.235 + *tokenType = TK_BITNOT;
1.236 + return 1;
1.237 + }
1.238 + case '`':
1.239 + case '\'':
1.240 + case '"': {
1.241 + int delim = z[0];
1.242 + for(i=1; (c=z[i])!=0; i++){
1.243 + if( c==delim ){
1.244 + if( z[i+1]==delim ){
1.245 + i++;
1.246 + }else{
1.247 + break;
1.248 + }
1.249 + }
1.250 + }
1.251 + if( c ){
1.252 + *tokenType = TK_STRING;
1.253 + return i+1;
1.254 + }else{
1.255 + *tokenType = TK_ILLEGAL;
1.256 + return i;
1.257 + }
1.258 + }
1.259 + case '.': {
1.260 +#ifndef SQLITE_OMIT_FLOATING_POINT
1.261 + if( !isdigit(z[1]) )
1.262 +#endif
1.263 + {
1.264 + *tokenType = TK_DOT;
1.265 + return 1;
1.266 + }
1.267 + /* If the next character is a digit, this is a floating point
1.268 + ** number that begins with ".". Fall thru into the next case */
1.269 + }
1.270 + case '0': case '1': case '2': case '3': case '4':
1.271 + case '5': case '6': case '7': case '8': case '9': {
1.272 + *tokenType = TK_INTEGER;
1.273 + for(i=0; isdigit(z[i]); i++){}
1.274 +#ifndef SQLITE_OMIT_FLOATING_POINT
1.275 + if( z[i]=='.' ){
1.276 + i++;
1.277 + while( isdigit(z[i]) ){ i++; }
1.278 + *tokenType = TK_FLOAT;
1.279 + }
1.280 + if( (z[i]=='e' || z[i]=='E') &&
1.281 + ( isdigit(z[i+1])
1.282 + || ((z[i+1]=='+' || z[i+1]=='-') && isdigit(z[i+2]))
1.283 + )
1.284 + ){
1.285 + i += 2;
1.286 + while( isdigit(z[i]) ){ i++; }
1.287 + *tokenType = TK_FLOAT;
1.288 + }
1.289 +#endif
1.290 + while( IdChar(z[i]) ){
1.291 + *tokenType = TK_ILLEGAL;
1.292 + i++;
1.293 + }
1.294 + return i;
1.295 + }
1.296 + case '[': {
1.297 + for(i=1, c=z[0]; c!=']' && (c=z[i])!=0; i++){}
1.298 + *tokenType = c==']' ? TK_ID : TK_ILLEGAL;
1.299 + return i;
1.300 + }
1.301 + case '?': {
1.302 + *tokenType = TK_VARIABLE;
1.303 + for(i=1; isdigit(z[i]); i++){}
1.304 + return i;
1.305 + }
1.306 + case '#': {
1.307 + for(i=1; isdigit(z[i]); i++){}
1.308 + if( i>1 ){
1.309 + /* Parameters of the form #NNN (where NNN is a number) are used
1.310 + ** internally by sqlite3NestedParse. */
1.311 + *tokenType = TK_REGISTER;
1.312 + return i;
1.313 + }
1.314 + /* Fall through into the next case if the '#' is not followed by
1.315 + ** a digit. Try to match #AAAA where AAAA is a parameter name. */
1.316 + }
1.317 +#ifndef SQLITE_OMIT_TCL_VARIABLE
1.318 + case '$':
1.319 +#endif
1.320 + case '@': /* For compatibility with MS SQL Server */
1.321 + case ':': {
1.322 + int n = 0;
1.323 + *tokenType = TK_VARIABLE;
1.324 + for(i=1; (c=z[i])!=0; i++){
1.325 + if( IdChar(c) ){
1.326 + n++;
1.327 +#ifndef SQLITE_OMIT_TCL_VARIABLE
1.328 + }else if( c=='(' && n>0 ){
1.329 + do{
1.330 + i++;
1.331 + }while( (c=z[i])!=0 && !isspace(c) && c!=')' );
1.332 + if( c==')' ){
1.333 + i++;
1.334 + }else{
1.335 + *tokenType = TK_ILLEGAL;
1.336 + }
1.337 + break;
1.338 + }else if( c==':' && z[i+1]==':' ){
1.339 + i++;
1.340 +#endif
1.341 + }else{
1.342 + break;
1.343 + }
1.344 + }
1.345 + if( n==0 ) *tokenType = TK_ILLEGAL;
1.346 + return i;
1.347 + }
1.348 +#ifndef SQLITE_OMIT_BLOB_LITERAL
1.349 + case 'x': case 'X': {
1.350 + if( z[1]=='\'' ){
1.351 + *tokenType = TK_BLOB;
1.352 + for(i=2; (c=z[i])!=0 && c!='\''; i++){
1.353 + if( !isxdigit(c) ){
1.354 + *tokenType = TK_ILLEGAL;
1.355 + }
1.356 + }
1.357 + if( i%2 || !c ) *tokenType = TK_ILLEGAL;
1.358 + if( c ) i++;
1.359 + return i;
1.360 + }
1.361 + /* Otherwise fall through to the next case */
1.362 + }
1.363 +#endif
1.364 + default: {
1.365 + if( !IdChar(*z) ){
1.366 + break;
1.367 + }
1.368 + for(i=1; IdChar(z[i]); i++){}
1.369 + *tokenType = keywordCode((char*)z, i);
1.370 + return i;
1.371 + }
1.372 + }
1.373 + *tokenType = TK_ILLEGAL;
1.374 + return 1;
1.375 +}
1.376 +
1.377 +/*
1.378 +** Run the parser on the given SQL string. The parser structure is
1.379 +** passed in. An SQLITE_ status code is returned. If an error occurs
1.380 +** then an and attempt is made to write an error message into
1.381 +** memory obtained from sqlite3_malloc() and to make *pzErrMsg point to that
1.382 +** error message.
1.383 +*/
1.384 +int sqlite3RunParser(Parse *pParse, const char *zSql, char **pzErrMsg){
1.385 + int nErr = 0;
1.386 + int i;
1.387 + void *pEngine;
1.388 + int tokenType;
1.389 + int lastTokenParsed = -1;
1.390 + sqlite3 *db = pParse->db;
1.391 + int mxSqlLen = db->aLimit[SQLITE_LIMIT_SQL_LENGTH];
1.392 +
1.393 + if( db->activeVdbeCnt==0 ){
1.394 + db->u1.isInterrupted = 0;
1.395 + }
1.396 + pParse->rc = SQLITE_OK;
1.397 + pParse->zTail = pParse->zSql = zSql;
1.398 + i = 0;
1.399 + assert( pzErrMsg!=0 );
1.400 + pEngine = sqlite3ParserAlloc((void*(*)(size_t))sqlite3Malloc);
1.401 + if( pEngine==0 ){
1.402 + db->mallocFailed = 1;
1.403 + return SQLITE_NOMEM;
1.404 + }
1.405 + assert( pParse->sLastToken.dyn==0 );
1.406 + assert( pParse->pNewTable==0 );
1.407 + assert( pParse->pNewTrigger==0 );
1.408 + assert( pParse->nVar==0 );
1.409 + assert( pParse->nVarExpr==0 );
1.410 + assert( pParse->nVarExprAlloc==0 );
1.411 + assert( pParse->apVarExpr==0 );
1.412 + while( !db->mallocFailed && zSql[i]!=0 ){
1.413 + assert( i>=0 );
1.414 + pParse->sLastToken.z = (u8*)&zSql[i];
1.415 + assert( pParse->sLastToken.dyn==0 );
1.416 + pParse->sLastToken.n = sqlite3GetToken((unsigned char*)&zSql[i],&tokenType);
1.417 + i += pParse->sLastToken.n;
1.418 + if( i>mxSqlLen ){
1.419 + pParse->rc = SQLITE_TOOBIG;
1.420 + break;
1.421 + }
1.422 + switch( tokenType ){
1.423 + case TK_SPACE:
1.424 + case TK_COMMENT: {
1.425 + if( db->u1.isInterrupted ){
1.426 + pParse->rc = SQLITE_INTERRUPT;
1.427 + sqlite3SetString(pzErrMsg, db, "interrupt");
1.428 + goto abort_parse;
1.429 + }
1.430 + break;
1.431 + }
1.432 + case TK_ILLEGAL: {
1.433 + sqlite3DbFree(db, *pzErrMsg);
1.434 + *pzErrMsg = sqlite3MPrintf(db, "unrecognized token: \"%T\"",
1.435 + &pParse->sLastToken);
1.436 + nErr++;
1.437 + goto abort_parse;
1.438 + }
1.439 + case TK_SEMI: {
1.440 + pParse->zTail = &zSql[i];
1.441 + /* Fall thru into the default case */
1.442 + }
1.443 + default: {
1.444 + sqlite3Parser(pEngine, tokenType, pParse->sLastToken, pParse);
1.445 + lastTokenParsed = tokenType;
1.446 + if( pParse->rc!=SQLITE_OK ){
1.447 + goto abort_parse;
1.448 + }
1.449 + break;
1.450 + }
1.451 + }
1.452 + }
1.453 +abort_parse:
1.454 + if( zSql[i]==0 && nErr==0 && pParse->rc==SQLITE_OK ){
1.455 + if( lastTokenParsed!=TK_SEMI ){
1.456 + sqlite3Parser(pEngine, TK_SEMI, pParse->sLastToken, pParse);
1.457 + pParse->zTail = &zSql[i];
1.458 + }
1.459 + sqlite3Parser(pEngine, 0, pParse->sLastToken, pParse);
1.460 + }
1.461 +#ifdef YYTRACKMAXSTACKDEPTH
1.462 + sqlite3StatusSet(SQLITE_STATUS_PARSER_STACK,
1.463 + sqlite3ParserStackPeak(pEngine)
1.464 + );
1.465 +#endif /* YYDEBUG */
1.466 + sqlite3ParserFree(pEngine, sqlite3_free);
1.467 + if( db->mallocFailed ){
1.468 + pParse->rc = SQLITE_NOMEM;
1.469 + }
1.470 + if( pParse->rc!=SQLITE_OK && pParse->rc!=SQLITE_DONE && pParse->zErrMsg==0 ){
1.471 + sqlite3SetString(&pParse->zErrMsg, db, "%s", sqlite3ErrStr(pParse->rc));
1.472 + }
1.473 + if( pParse->zErrMsg ){
1.474 + if( *pzErrMsg==0 ){
1.475 + *pzErrMsg = pParse->zErrMsg;
1.476 + }else{
1.477 + sqlite3DbFree(db, pParse->zErrMsg);
1.478 + }
1.479 + pParse->zErrMsg = 0;
1.480 + nErr++;
1.481 + }
1.482 + if( pParse->pVdbe && pParse->nErr>0 && pParse->nested==0 ){
1.483 + sqlite3VdbeDelete(pParse->pVdbe);
1.484 + pParse->pVdbe = 0;
1.485 + }
1.486 +#ifndef SQLITE_OMIT_SHARED_CACHE
1.487 + if( pParse->nested==0 ){
1.488 + sqlite3DbFree(db, pParse->aTableLock);
1.489 + pParse->aTableLock = 0;
1.490 + pParse->nTableLock = 0;
1.491 + }
1.492 +#endif
1.493 +#ifndef SQLITE_OMIT_VIRTUALTABLE
1.494 + sqlite3DbFree(db, pParse->apVtabLock);
1.495 +#endif
1.496 +
1.497 + if( !IN_DECLARE_VTAB ){
1.498 + /* If the pParse->declareVtab flag is set, do not delete any table
1.499 + ** structure built up in pParse->pNewTable. The calling code (see vtab.c)
1.500 + ** will take responsibility for freeing the Table structure.
1.501 + */
1.502 + sqlite3DeleteTable(pParse->pNewTable);
1.503 + }
1.504 +
1.505 + sqlite3DeleteTrigger(db, pParse->pNewTrigger);
1.506 + sqlite3DbFree(db, pParse->apVarExpr);
1.507 + if( nErr>0 && (pParse->rc==SQLITE_OK || pParse->rc==SQLITE_DONE) ){
1.508 + pParse->rc = SQLITE_ERROR;
1.509 + }
1.510 + return nErr;
1.511 +}