/* * The Regina Rexx Interpreter * Copyright (C) 1992-1994 Anders Christensen * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Library General Public * License as published by the Free Software Foundation; either * version 2 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Library General Public License for more details. * * You should have received a copy of the GNU Library General Public * License along with this library; if not, write to the Free * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ #include "rexx.h" #include #include #include #include #include #ifdef HAVE_UNISTD_H # include #endif #include #include "rexxmsg.h" /* MAX_ET_BUFFERS is the maximum number of strings required to be allocated when an error occurs */ #define MAX_ET_BUFFERS 10 typedef struct /* err_tsd: static variables of this module (thread-safe) */ { int number_messages; int native_language; FILE *nls_fp; streng *buffer[MAX_ET_BUFFERS]; struct textindex nls_tmi[NUMBER_ERROR_MESSAGES]; /* indexes for native language messages */ int number_prefix_messages; /* new */ struct textindex nls_tpi[NUMBER_PREFIX_MESSAGES]; /* indexes for prefix messages */ int conditions; streng *errornum; } err_tsd_t; /* thread-specific but only needed by this module. see init_error */ typedef struct { int errnum; int suberrnum; char *text; } errtext_t; /* * English message text - generated by makeerror.rexx */ static const errtext_t errtext[NUMBER_ERROR_MESSAGES] = { { 0, 1,"Error %s running %s, line %d:|,," }, { 0, 2,"Error %s in interactive trace:|" }, { 0, 3,"Interactive trace. \"Trace Off\" to end debug. ENTER to continue." }, { 2, 0,"Failure during finalization" }, { 2, 1,"Failure during finalization: %s|" }, { 3, 0,"Failure during initialization" }, { 3, 1,"Failure during initialization: %s|" }, { 4, 0,"Program interrupted" }, { 4, 1,"Program interrupted with HALT condition: %s|" }, { 5, 0,"System resources exhausted" }, { 5, 1,"System resources exhausted: %s|" }, { 6, 0,"Unmatched \"/*\" or quote" }, { 6, 1,"Unmatched comment delimiter (\"/*\")" }, { 6, 2,"Unmatched single quote (')" }, { 6, 3,"Unmatched double quote (\")" }, { 7, 0,"WHEN or OTHERWISE expected" }, { 7, 1,"SELECT on line %d requires WHEN; found \"%s\"|," }, { 7, 2,"SELECT on line %d requires WHEN, OTHERWISE, or END; found \"%s\"|," }, { 7, 3,"All WHEN expressions of SELECT on line %d are false; OTHERWISE expected|" }, { 8, 0,"Unexpected THEN or ELSE" }, { 8, 1,"THEN has no corresponding IF or WHEN clause" }, { 8, 2,"ELSE has no corresponding THEN clause" }, { 9, 0,"Unexpected WHEN or OTHERWISE" }, { 9, 1,"WHEN has no corresponding SELECT" }, { 9, 2,"OTHERWISE has no corresponding SELECT" }, { 10, 0,"Unexpected or unmatched END" }, { 10, 1,"END has no corresponding DO or SELECT" }, { 10, 2,"END corresponding to DO on line %d must have a symbol following that matches the control variable (or no symbol); found \"%s\"|," }, { 10, 3,"END corresponding to DO on line %d must not have a symbol following it because there is no control variable; found \"%s\"|," }, { 10, 4,"END corresponding to SELECT on line %d must not have a symbol following; found \"%s\"|," }, { 10, 5,"END must not immediately follow THEN" }, { 10, 6,"END must not immediately follow ELSE" }, { 11, 0,"[Control stack full]" }, { 12, 0,"[Clause > 1024 characters]" }, { 13, 0,"Invalid character in program" }, { 13, 1,"Invalid character in program \"('%x'X)\"|" }, { 14, 0,"Incomplete DO/SELECT/IF" }, { 14, 1,"DO instruction requires a matching END" }, { 14, 2,"SELECT instruction requires a matching END" }, { 14, 3,"THEN requires a following instruction" }, { 14, 4,"ELSE requires a following instruction" }, { 15, 0,"Invalid hexadecimal or binary string" }, { 15, 1,"Invalid location of blank in position %d in hexadecimal string|" }, { 15, 2,"Invalid location of blank in position %d in binary string|" }, { 15, 3,"Only 0-9, a-f, A-F, and blank are valid in a hexadecimal string; found \"%c\"|" }, { 15, 4,"Only 0, 1, and blank are valid in a binary string; found \"%c\"|" }, { 16, 0,"Label not found" }, { 16, 1,"Label \"%s\" not found|" }, { 16, 2,"Cannot SIGNAL to label \"%s\" because it is inside an IF, SELECT or DO group|" }, { 16, 3,"Cannot invoke label \"%s\" because it is inside an IF, SELECT or DO group|" }, { 17, 0,"Unexpected PROCEDURE" }, { 17, 1,"PROCEDURE is valid only when it is the first instruction executed after an internal CALL or function invocation" }, { 18, 0,"THEN expected" }, { 18, 1,"IF keyword on line %d requires matching THEN clause; found \"%s\"|," }, { 18, 2,"WHEN keyword on line %d requires matching THEN clause; found \"%s\"|," }, { 19, 0,"String or symbol expected" }, { 19, 1,"String or symbol expected after ADDRESS keyword; found \"%s\"|" }, { 19, 2,"String or symbol expected after CALL keyword; found \"%s\"|" }, { 19, 3,"String or symbol expected after NAME keyword; found \"%s\"|" }, { 19, 4,"String or symbol expected after SIGNAL keyword; found \"%s\"|" }, { 19, 6,"String or symbol expected after TRACE keyword; found \"%s\"|" }, { 19, 7,"Symbol expected in parsing pattern; found \"%s\"|" }, { 20, 0,"Name expected" }, { 20, 1,"Name required; found \"%s\"|" }, { 20, 2,"Found \"%s\" where only a name is valid|" }, { 21, 0,"Invalid data on end of clause" }, { 21, 1,"The clause ended at an unexpected token; found \"%s\"|" }, { 22, 0,"Invalid character string" }, { 22, 1,"Invalid character string '%s'X|" }, { 23, 0,"Invalid data string" }, { 23, 1,"Invalid data string '%s'X|" }, { 24, 0,"Invalid TRACE request" }, { 24, 1,"TRACE request letter must be one of \"%s\"; found \"%c\"|ACEFILNOR," }, { 25, 0,"Invalid sub-keyword found" }, { 25, 1,"CALL ON must be followed by one of the keywords %s; found \"%s\"|," }, { 25, 2,"CALL OFF must be followed by one of the keywords %s; found \"%s\"|," }, { 25, 3,"SIGNAL ON must be followed by one of the keywords %s; found \"%s\"|," }, { 25, 4,"SIGNAL OFF must be followed by one of the keywords %s; found \"%s\"|," }, { 25, 5,"ADDRESS WITH must be followed by one of the keywords INPUT, OUTPUT or ERROR; found \"%s\"|" }, { 25, 6,"INPUT must be followed by one of the keywords STREAM, STEM, LIFO, FIFO, NOEOL or NORMAL; found \"%s\"|" }, { 25, 7,"OUTPUT must be followed by one of the keywords STREAM, STEM, LIFO, FIFO, APPEND, REPLACE or NORMAL; found \"%s\"|" }, { 25, 8,"APPEND must be followed by one of the keywords STREAM, STEM, LIFO or FIFO; found \"%s\"|" }, { 25, 9,"REPLACE must be followed by one of the keywords STREAM, STEM, LIFO or FIFO; found \"%s\"|" }, { 25, 11,"NUMERIC FORM must be followed by one of the keywords %s; found \"%s\"|," }, { 25, 12,"PARSE must be followed by one of the keywords %s; found \"%s\"|," }, { 25, 13,"UPPER must be followed by one of the keywords %s; found \"%s\"|," }, { 25, 14,"ERROR must be followed by one of the keywords STREAM, STEM, LIFO, FIFO, APPEND, REPLACE or NORMAL; found \"%s\"|" }, { 25, 15,"NUMERIC must be followed by one of the keywords %s; found \"%s\"|," }, { 25, 16,"FOREVER must be followed by one of the keywords %s; found \"%s\"|," }, { 25, 17,"PROCEDURE must be followed by the keyword EXPOSE or nothing; found \"%s\"|" }, { 26, 0,"Invalid whole number" }, { 26, 1,"Whole numbers must fit within current DIGITS setting(%d); found \"%s\"|," }, { 26, 2,"Value of repetition count expression in DO instruction must be zero or a positive whole number; found \"%s\"|" }, { 26, 3,"Value of FOR expression in DO instruction must be zero or a positive whole number; found \"%s\"|" }, { 26, 4,"Positional parameter of parsing template must be a whole number; found \"%s\"|" }, { 26, 5,"NUMERIC DIGITS value must be a positive whole number; found \"%s\"|" }, { 26, 6,"NUMERIC FUZZ value must be zero or a positive whole number; found \"%s\"|" }, { 26, 7,"Number used in TRACE setting must be a whole number; found \"%s\"|" }, { 26, 8,"Operand to right of power operator (\"**\") must be a whole number; found \"%s\"|" }, { 26, 11,"Result of %s %% %s operation would need exponential notation at current NUMERIC DIGITS %d|,," }, { 26, 12,"Result of %% operation used for %s // %s operation would need exponential notation at current NUMERIC DIGITS %d|,," }, { 27, 0,"Invalid DO syntax" }, { 27, 1,"Invalid use of keyword \"%s\" in DO clause|" }, { 28, 0,"Invalid LEAVE or ITERATE" }, { 28, 1,"LEAVE is valid only within a repetitive DO loop" }, { 28, 2,"ITERATE is valid only within a repetitive DO loop" }, { 28, 3,"Symbol following LEAVE (\"%s\") must either match control variable of a current DO loop or be omitted|" }, { 28, 4,"Symbol following ITERATE (\"%s\") must either match control variable of a current DO loop or be omitted|" }, { 29, 0,"Environment name too long" }, { 29, 1,"Environment name exceeds %d characters; found \"%s\"|#Limit_EnvironmentName," }, { 30, 0,"Name or string too long" }, { 30, 1,"Name exceeds %d characters|#Limit_Name" }, { 30, 2,"Literal string exceeds %d characters|#Limit_Literal" }, { 31, 0,"Name starts with number or \".\"" }, { 31, 1,"A value cannot be assigned to a number; found \"%s\"|" }, { 31, 2,"Variable symbol must not start with a number; found \"%s\"|" }, { 31, 3,"Variable symbol must not start with a \".\"; found \"%s\"|" }, { 32, 0,"[Invalid use of stem]" }, { 33, 0,"Invalid expression result" }, { 33, 1,"Value of NUMERIC DIGITS (\"%d\") must exceed value of NUMERIC FUZZ (\"%d\")|," }, { 33, 2,"Value of NUMERIC DIGITS (\"%d\") must not exceed %d|,#Limit_Digits" }, { 33, 3,"Result of expression following NUMERIC FORM must start with \"E\" or \"S\"; found \"%s\"|" }, { 34, 0,"Logical value not \"0\" or \"1\"" }, { 34, 1,"Value of expression following IF keyword must be exactly \"0\" or \"1\"; found \"%s\"|" }, { 34, 2,"Value of expression following WHEN keyword must be exactly \"0\" or \"1\"; found \"%s\"|" }, { 34, 3,"Value of expression following WHILE keyword must be exactly \"0\" or \"1\"; found \"%s\"|" }, { 34, 4,"Value of expression following UNTIL keyword must be exactly \"0\" or \"1\"; found \"%s\"|" }, { 34, 5,"Value of expression to left of logical operator \"%s\" must be exactly \"0\" or \"1\"; found \"%s\"|," }, { 34, 6,"Value of expression to right of logical operator \"%s\" must be exactly \"0\" or \"1\"; found \"%s\"|," }, { 35, 0,"Invalid expression" }, { 35, 1,"Invalid expression detected at \"%s\"|" }, { 36, 0,"Unmatched \"(\" in expression" }, { 37, 0,"Unexpected \",\" or \")\"" }, { 37, 1,"Unexpected \",\"" }, { 37, 2,"Unmatched \")\" in expression" }, { 38, 0,"Invalid template or pattern" }, { 38, 1,"Invalid parsing template detected at \"%s\"|" }, { 38, 2,"Invalid parsing position detected at \"%s\"|" }, { 38, 3,"PARSE VALUE instruction requires WITH keyword" }, { 39, 0,"[Evaluation stack overflow]" }, { 40, 0,"Incorrect call to routine" }, { 40, 1,"External routine \"%s\" failed|" }, { 40, 3,"Not enough arguments in invocation of \"%s\"; minimum expected is %d|," }, { 40, 4,"Too many arguments in invocation of \"%s\"; maximum expected is %d|," }, { 40, 5,"Missing argument in invocation of \"%s\"; argument %d is required|," }, { 40, 9,"%s argument %d exponent exceeds %d digits; found \"%s\"|,,#Limit_ExponentDigits," }, { 40, 11,"%s argument %d must be a number; found \"%s\"|,," }, { 40, 12,"%s argument %d must be a whole number; found \"%s\"|,," }, { 40, 13,"%s argument %d must be zero or positive; found \"%s\"|,," }, { 40, 14,"%s argument %d must be positive; found \"%s\"|,," }, { 40, 17,"%s argument 1, must have an integer part in the range 0:90 and a decimal part no larger than .9; found \"%s\"|," }, { 40, 18,"%s conversion must have a year in the range 0001 to 9999|" }, { 40, 19,"%s argument 2, \"%s\", is not in the format described by argument 3, \"%s\"|,," }, { 40, 21,"%s argument %d must not be null|," }, { 40, 23,"%s argument %d must be a single character; found \"%s\"|,," }, { 40, 24,"%s argument 1 must be a binary string; found \"%s\"|," }, { 40, 25,"%s argument 1 must be a hexadecimal string; found \"%s\"|," }, { 40, 26,"%s argument 1 must be a valid symbol; found \"%s\"|," }, { 40, 27,"%s argument 1, must be a valid stream name; found \"%s\"|," }, { 40, 28,"%s argument %d, option must start with one of \"%s\"; found \"%s\"|,,," }, { 40, 29,"%s conversion to format \"%s\" is not allowed|," }, { 40, 31,"%s argument 1 (\"%d\") must not exceed 100000|," }, { 40, 32,"%s the difference between argument 1 (\"%d\") and argument 2 (\"%d\") must not exceed 100000|,," }, { 40, 33,"%s argument 1 (\"%d\") must be less than or equal to argument 2 (\"%d\")|,," }, { 40, 34,"%s argument 1 (\"%d\") must be less than or equal to the number of lines in the program (%d)|,," }, { 40, 35,"%s argument 1 cannot be expressed as a whole number; found \"%s\"|," }, { 40, 36,"%s argument 1 must be a name of a variable in the pool; found \"%s\"|," }, { 40, 37,"%s argument 3 must be the name of a pool; found \"%s\"|," }, { 40, 38,"%s argument %d is not large enough to format \"%s\"|,," }, { 40, 39,"%s argument 3 is not zero or one; found \"%s\"|," }, { 40, 41,"%s argument %d must be within the bounds of the stream; found \"%s\"|,," }, { 40, 42,"%s argument 1; cannot position on this stream; found \"%s\"|," }, { 40, 43,"%s argument %d must be a single non-alphanumeric character or the null string; found \"%s\"|,," }, { 40, 44,"%s argument %d, \"%s\", is a format incompatible with the separator specified in argument %d|,,," }, { 40,914,"[%s argument %d, must be one of \"%s\"; found \"%s\"]|,,," }, { 40,920,"[%s: low-level stream I/O error; %s]|," }, { 40,921,"[%s argument %d, stream positioning mode \"%s\"; incompatible with stream open mode]|,," }, { 40,922,"[%s argument %d, too few sub-commands; minimum expected is %d; found %d]|,,," }, { 40,923,"[%s argument %d, too many sub-commands; maximum expected is %d; found %d]|,,," }, { 40,924,"[%s argument %d, invalid positional specification; expecting one of \"%s\"; found \"%s\"]|,,," }, { 40,930,"[RXQUEUE, function TIMEOUT, expecting a whole number between 0 and %d; found \"%s\"]|," }, { 40,980,"Unexpected input, either unknown type or illegal data%s%s|: ," }, { 40,981,"Number out of the allowed range%s%s|: ," }, { 40,982,"String too big for the defined buffer%s%s|: ," }, { 40,983,"Illegal combination of type/size%s%s|: ," }, { 40,984,"Unsupported number like NAN, +INF, -INF%s%s|: ," }, { 40,985,"Structure too complex for static internal buffer%s%s|: ," }, { 40,986,"An element of the structure is missing%s%s|: ," }, { 40,987,"A value of the structure is missing%s%s|: ," }, { 40,988,"The name or part of the name is illegal for the interpreter%s%s|: ," }, { 40,989,"A problem raises at the interface between Regina and GCI%s%s|: ," }, { 40,990,"The type won't fit the requirements for basic types (arguments/return value)%s%s|: ," }, { 40,991,"The number of arguments is wrong or an argument is missing%s%s|: ," }, { 40,992,"GCI's internal stack for arguments got an overflow%s%s|: ," }, { 40,993,"GCI counted too many nested LIKE containers%s%s|: ," }, { 41, 0,"Bad arithmetic conversion" }, { 41, 1,"Non-numeric value (\"%s\") to left of arithmetic operation \"%s\"|," }, { 41, 2,"Non-numeric value (\"%s\") to right of arithmetic operation \"%s\"|," }, { 41, 3,"Non-numeric value (\"%s\") used with prefix operator \"%s\"|," }, { 41, 4,"Value of TO expression in DO instruction must be numeric; found \"%s\"|" }, { 41, 5,"Value of BY expression in DO instruction must be numeric; found \"%s\"|" }, { 41, 6,"Value of control variable expression of DO instruction must be numeric; found \"%s\"|" }, { 41, 7,"Exponent exceeds %d digits; found \"%s\"|#Limit_ExponentDigits," }, { 42, 0,"Arithmetic overflow/underflow" }, { 42, 1,"Arithmetic overflow detected at \"%s %s %s\"; exponent of result requires more than %d digits|,,,#Limit_ExponentDigits" }, { 42, 2,"Arithmetic underflow detected at \"%s %s %s\"; exponent of result requires more than %d digits|,,,#Limit_ExponentDigits" }, { 42, 3,"Arithmetic overflow; divisor must not be zero" }, { 43, 0,"Routine not found" }, { 43, 1,"Could not find routine \"%s\"|" }, { 44, 0,"Function did not return data" }, { 44, 1,"No data returned from function \"%s\"|" }, { 45, 0,"No data specified on function RETURN" }, { 45, 1,"Data expected on RETURN instruction because routine \"%s\" was called as a function|" }, { 46, 0,"Invalid variable reference" }, { 46, 1,"Extra token (\"%s\") found in variable reference; \")\" expected|" }, { 47, 0,"Unexpected label" }, { 47, 1,"INTERPRET data must not contain labels; found \"%s\"|" }, { 48, 0,"Failure in system service" }, { 48, 1,"Failure in system service: %s|" }, { 48,920,"Low-level stream I/O error: %s %s: %s|,," }, { 49, 0,"Interpretation Error" }, { 49, 1,"Interpretation Error: Failed in %s, line %d: \"%s\". Please report error!|,," }, { 50, 0,"Unrecognized reserved symbol" }, { 50, 1,"Unrecognized reserved symbol \"%s\"|" }, { 51, 0,"Invalid function name" }, { 51, 1,"Unquoted function names must not end in a period; found \"%s\"|" }, { 52, 0,"Result returned by \"%s\" is longer than %d characters|,#Limit_String" }, { 53, 0,"Invalid option" }, { 53, 1,"String or symbol expected after STREAM keyword; found \"%s\"|" }, { 53, 2,"Variable reference expected after STEM keyword; found \"%s\"|" }, { 53, 3,"Argument to STEM must have one period, as its last character; found \"%s\"|" }, { 53,100,"String or symbol expected after LIFO keyword; found \"%s\"|" }, { 53,101,"String or symbol expected after FIFO keyword; found \"%s\"|" }, { 54, 0,"Invalid STEM value" }, { 54, 1,"For this STEM APPEND, the value of \"%s\" must be a count of lines; found \"%s\"|," }, { 60, 0,"[Can't rewind transient file]" }, { 61, 0,"[Improper seek operation on file]" }, { 64, 0,"[Syntax error while parsing]" }, { 64, 1,"[Syntax error at line %d]" }, { 64, 2,"[General syntax error at line %d, column %d]|," }, { 90, 0,"[Non-ANSI feature used with \"OPTIONS STRICT_ANSI\"]" }, { 90, 1,"[%s is a Regina extension BIF]|" }, { 90, 2,"[%s is a Regina extension instruction]|" }, { 90, 3,"[%s argument %d, option must start with one of \"%s\" with \"OPTIONS STRICT_ANSI\"; found \"%s\"; a Regina extension]|,,," }, { 90, 4,"[%s is a Regina extension operator]|" }, { 93, 0,"[Incorrect call to routine]" }, { 93, 1,"[STREAM command %s must be followed by one of \"%s\"; found \"%s\"]|,," }, { 93, 3,"[STREAM command must be one of \"%s\"; found \"%s\"]|," }, { 94, 0,"[External queue interface error]" }, { 94, 1,"[External queue timed out]" }, { 94, 99,"[Internal error with external queue interface: %d \"%s\"]|," }, { 94,100,"[General system error with external queue interface. %s. %s]|," }, { 94,101,"[Error connecting to %s on port %d: \"%s\"]|,," }, { 94,102,"[Unable to obtain IP address for %s]|" }, { 94,103,"[Invalid format for server in specified queue name: \"%s\"]|" }, { 94,104,"[Invalid format for queue name: \"%s\"]|" }, { 94,105,"[Unable to start Windows Socket interface: %s]|" }, { 94,106,"[Maximum number of external queues exceeded: %d]|" }, { 94,107,"[Error occurred reading socket: %s]|" }, { 94,108,"[Invalid switch passed. Must be one of \"%s\"]|" }, { 94,109,"[Queue \"%s\" not found]|" }, { 94,110,"[%s invalid for external queues]|" }, { 94,111,"[RXQUEUE function %s invalid for internal queues]|" }, { 94,112,"[Unable to %s SESSION queue]|" }, { 95, 0,"[Restricted feature used in \"safe\" mode]" }, { 95, 1,"[%s invalid in \"safe\" mode]|" }, { 95, 2,"[%s argument %d invalid in \"safe\" mode]|," }, { 95, 3,"[%s argument %d: \"%s\", invalid in \"safe\" mode]|,," }, { 95, 4,"[STREAM argument 3: Opening files for WRITE access invalid in \"safe\" mode]" }, { 95, 5,"[Running external commands invalid in \"safe\" mode]" }, { 100, 0,"[Unknown filesystem error]" }, /* * Do not use an error number > 100, these are treated as system errors (errno-100) and the * error string is obtained from strerror(). */ } ; /* * Static pointers to language-specific error messages * IF THIS EVER CHANGES, ALSO CHANGE THE SAME TABLE IN msgcmp.c */ static const char *errlang[] = { "en", /* english */ "de", /* german */ "es", /* spanish */ "no", /* norwegian */ "pt", /* portuguese */ "pl", /* polish */ "sv", /* swedish */ "tr", /* turkish */ NULL } ; #define ERR1PREFIX_IDX 0 #define SUBERRPREFIX_IDX 1 #define ERR2PREFIX_IDX 2 static const char *err1prefix = "Error %d running \"%.*s\", line %d: %.*s"; static const char *suberrprefix = "Error %d.%d: %.*s"; static const char *err2prefix = "Error %d running \"%.*s\": %.*s"; static const char *erropen = "Unable to open language file: %s"; static const char *errcount = "Incorrect number of messages in language file: %s"; static const char *errread = "Unable to read from language file: %s"; static const char *errmissing = "Text missing from language file: %s.mtb"; static const char *errcorrupt = "Language file: %s.mtb is corrupt"; static const char *get_embedded_text_message( int errorno, int suberrorno ); /* init_error initializes the module. * Currently, we set up the thread specific data. * The function returns 1 on success, 0 if memory is short. */ int init_error( tsd_t *TSD ) { err_tsd_t *et; if (TSD->err_tsd != NULL) return(1); if ( ( TSD->err_tsd = MallocTSD( sizeof(err_tsd_t) ) ) == NULL ) return(0); et = (err_tsd_t *)TSD->err_tsd; memset( et, 0, sizeof(err_tsd_t) ); et->errornum = Str_makeTSD( 3 * sizeof( int ) ); return(1); } /* * get_buffer allocates a buffer from one of the internal buffers. * No optimusation is done. Memory is cleard by clear-buffers() * A returned buffer will always have a size of 0. * This should never exhaust all memory! */ static streng *get_buffer( const tsd_t *TSD, unsigned minsize ) { err_tsd_t *et = (err_tsd_t *)TSD->err_tsd; int idx=-1; minsize++; for ( idx = 0; idx < MAX_ET_BUFFERS; idx++ ) { if ( et->buffer[idx] == NULL ) { et->buffer[idx] = Str_makeTSD( minsize ); break; } } Str_len(et->buffer[idx]) = 0; return et->buffer[idx]; } /* * clear_errortext_buffers frees up memory used for internal buffers */ void clear_errortext_buffers( const tsd_t *TSD ) { err_tsd_t *et = (err_tsd_t *)TSD->err_tsd; int idx=-1; for ( idx = 0; idx < MAX_ET_BUFFERS; idx++ ) { if ( et->buffer[idx] != NULL ) { Free_stringTSD( et->buffer[idx] ); /* * Fix for Bug #436. Enable system exit to trap parsing errors */ et->buffer[idx] = NULL; } } } int lineno_of( cnodeptr node ) { if (node) return (node->lineno>=0) ? node->lineno : 0 ; else return 0 ; } static int charno_of( cnodeptr node ) { if (node) return (node->charnr>=0) ? node->charnr : 0 ; else return 0 ; } /* * Returns a 0-terminated string in a streng which will be formatted by a * "string formatter" which argument is arg. */ static streng *simple_msg( const tsd_t *TSD, const char *fmt, const char *arg ) { int lf = strlen( fmt ); int la = strlen( arg ); streng *retval; retval = get_buffer( TSD, lf + la ); Str_len( retval ) = sprintf( retval->value, fmt, arg ); return retval; } static streng *get_text_message( const tsd_t *TSD, FILE *fp, unsigned fileoffset, unsigned textlength, int errorno, int suberrorno, int *is_fmt ) { err_tsd_t *et; streng *retval; const char *errfn; et = (err_tsd_t *)TSD->err_tsd; #if defined(__EPOC32__) || defined(__WINS__) errfn="default"; #else errfn=errlang[et->native_language]; #endif if ( fseek( fp, fileoffset, SEEK_SET ) == -1 ) { *is_fmt = 0; return simple_msg( TSD, errcorrupt, errfn ); } retval = get_buffer( TSD, textlength + 1 ); if ( fread( retval->value, 1, textlength, fp ) != textlength ) { *is_fmt = 0; return simple_msg( TSD, errcorrupt, errfn ); } retval->value[textlength] = '\0'; Str_len(retval) = textlength; return retval; } static const char *get_embedded_text_message( int errorno, int suberrorno ) { int i; for ( i = 0; i < NUMBER_ERROR_MESSAGES; i++ ) { if ( errtext[i].errnum == errorno && errtext[i].suberrnum == suberrorno ) { return errtext[i].text; } } return ""; } /* only to be used by syntax and runtime errors, and the halt condition * FIXME: FGC: This function is used while initializing the runtime system. * Maybe, we don't have a functional tsd_t! * What shall we do? */ void exiterror( int errorno, int suberrorno, ... ) { staticstreng( nofile, "" ); va_list argptr; int lineno,signtype; /* int charno; could be useful for pinpointing actual error */ streng *inputfile; streng *suberror_streng=NULL; streng *errmsg, *ptr; int i,ok,len; const streng *fmt, *etext ; FILE *fp = stderr ; err_tsd_t *et; int is_fmt=1; tsd_t *TSD = __regina_get_tsd(); /* The TSD should be fetched directly. This * will help if someone corrupted a TSD as * an argument. * A "fresh" value is always better for * tracking down ugly errors. * Speed advantage is no reason here! */ et = (err_tsd_t *)TSD->err_tsd; if ( ( et == NULL ) || ( ( errorno == ERR_STORAGE_EXHAUSTED ) && ( et->conditions > 10 ) ) ) { const char *out = get_embedded_text_message( errorno, 0 ); len = strlen( out ); /* * We allow 10 pending errors only before doing a hard cleanup. * You can use any fixed limit as far as we stop at some time when * having a permanent memory allocation error. * Just write a description end exit. DON'T DO USE A ROUTINE CALLING A * MEMORY ALLOCATION ROUTINE! */ if ( ( TSD->currlevel != NULL ) && get_options_flag( TSD->currlevel, EXT_STDOUT_FOR_STDERR ) ) fp = stdout; fwrite( out, len, 1, fp ); #if defined(DOS) || defined(OS2) || defined(WIN32) /* * stdout is open in binary mode, so we need to add the * extra CR to the end of the line. */ fputc( REGINA_CR, fp ); #endif fputc( REGINA_EOL, fp ); goto not_hookable; } et->conditions++; if ( TSD->currentnode ) { lineno = lineno_of( TSD->currentnode ); /* charno = charno_of( TSD->currentnode ); */ } else { /* charno = 0; */ lineno = parser_data.tline; } signtype = SIGNAL_SYNTAX; if ( errorno == ERR_PROG_INTERRUPT ) signtype = SIGNAL_HALT; #ifdef HAVE_VSPRINTF /* * Expanded the sub-error text and pass this to condition_hook for * condition('D') to return the expanded string. */ if ( ( errorno <= ERR_MAX_NUMBER ) && ( suberrorno != 0 ) ) { fmt = errortext( TSD, errorno, suberrorno, 0, 0 ); len = Str_len( fmt ); is_fmt = 1; if ( et->native_language == LANGUAGE_ENGLISH || et->nls_fp == NULL ) { ptr = simple_msg( TSD, "%s", suberrprefix ); } else { ptr = get_text_message( TSD, et->nls_fp, et->nls_tpi[SUBERRPREFIX_IDX].fileoffset, et->nls_tpi[SUBERRPREFIX_IDX].textlength, errorno, suberrorno, &is_fmt ); if ( !is_fmt ) { ptr = simple_msg( TSD, "%s", suberrprefix ); } } len += Str_len( ptr ); len += 2 * ( ( sizeof(unsigned) * 8 ) / 3 + 2 ); errmsg = get_buffer( TSD, len + 3 ); len = sprintf( errmsg->value, ptr->value, errorno, suberrorno, Str_len( fmt ), fmt->value ); va_start( argptr, suberrorno ); for ( i = 0; i < Str_len( fmt ); i++ ) { if ( fmt->value[i] == '%' ) { switch ( fmt->value[i+1] ) { case 's': len += strlen( va_arg( argptr, char * ) ); break; case 'c': /* assignment to anything inhibits compiler warnings */ ok = (int) va_arg( argptr, int ); break; case '%': /* Fixes 1107759 */ i++; break; default: len += ( sizeof( unsigned ) * 8 ) / 3 + 2; /* assignment to anything inhibits compiler warnings */ ok = (int) va_arg( argptr, unsigned ); break; } } } va_end( argptr ); suberror_streng = Str_makeTSD( len + 1 ); if ( suberror_streng ) { va_start( argptr, suberrorno ); Str_len( suberror_streng ) = vsprintf( suberror_streng->value, errmsg->value, argptr ); va_end( argptr ); } } #endif /* Here we should set sigtype to SIGNAL_FATAL for some 'errno's */ /* clean up internal buffers before calling condition_hook() as this may not return */ /* Fixes bug #463 */ clear_errortext_buffers( TSD ); /* Get the text for the base errorno for condition_hook() */ etext = errortext( TSD, errorno, 0, 0, 0 ); /* * Only in case of a SYNTAX error set .MN, ANSI 8.4.1 * Keep care of 64 bit machines. A huge number may contain 80 characters * and we are not allowed to use ints, we have to use unsigneds. */ if ( signtype == SIGNAL_SYNTAX ) { char num[2 * ( ( sizeof(unsigned) * 8 ) / 3 + 2 )]; if ( suberrorno ) { sprintf( num, "%u.%u", (unsigned) errorno, (unsigned) suberrorno ); set_reserved_value( TSD, POOL0_MN, Str_creTSD( num ), 0, VFLAG_STR ); } else set_reserved_value( TSD, POOL0_MN, NULL, errorno, VFLAG_NUM ); } /* enable a hook into the condition system */ et->conditions--; if ( condition_hook( TSD, signtype, errorno, suberrorno, lineno, Str_dupTSD( etext ), suberror_streng ) ) { if ( suberror_streng ) Free_stringTSD( suberror_streng ); suberror_streng = NULL; return ; /* if CALL ON */ } et->conditions++; if ( ( inputfile = TSD->systeminfo->input_file ) == NULL ) inputfile = (streng *) nofile; ok = HOOK_GO_ON; if ( lineno > 0 ) { traceback( TSD ); if ( et->native_language == LANGUAGE_ENGLISH || et->nls_fp == NULL ) { ptr = simple_msg( TSD, "%s", err1prefix ); } else { is_fmt = 1; ptr = get_text_message( TSD, et->nls_fp, et->nls_tpi[ERR1PREFIX_IDX].fileoffset, et->nls_tpi[ERR1PREFIX_IDX].textlength, errorno, suberrorno, &is_fmt ); if ( !is_fmt ) { ptr = simple_msg( TSD, "%s", err1prefix ); } } errmsg = Str_makeTSD( 80 + Str_len( etext ) + Str_len( inputfile ) + Str_len( ptr ) ); sprintf( errmsg->value, ptr->value, errorno, Str_len( inputfile ), inputfile->value, lineno, Str_len( etext ), etext->value ); } else { if ( et->native_language == LANGUAGE_ENGLISH || et->nls_fp == NULL ) { ptr = simple_msg( TSD, "%s", err2prefix ); } else { is_fmt = 1; ptr = get_text_message( TSD, et->nls_fp, et->nls_tpi[ERR2PREFIX_IDX].fileoffset, et->nls_tpi[ERR2PREFIX_IDX].textlength, errorno, suberrorno, &is_fmt ); if ( !is_fmt ) { ptr = simple_msg( TSD, "%s", err2prefix ); } } errmsg = Str_makeTSD( 80 + Str_len( etext ) + Str_len( inputfile ) + Str_len( ptr ) ); sprintf( errmsg->value, ptr->value, errorno, Str_len( inputfile ), inputfile->value, Str_len( etext ), etext->value ); } errmsg->len = strlen( errmsg->value ); assert( errmsg->len < errmsg->max ); /* * If we have a system exit installed to handle errors, call it here... */ et->conditions--; if ( TSD->systeminfo->hooks & HOOK_MASK( HOOK_STDERR ) ) ok = hookup_output( TSD, HOOK_STDERR, errmsg ) == HOOK_GO_ON; if ( ok == HOOK_GO_ON ) { /* * To get here we either don't have an exit handler or the exit * handler refused to handle the message, so write it to the * error (or output) stream. */ if ( get_options_flag( TSD->currlevel, EXT_STDOUT_FOR_STDERR ) ) fp = stdout; fwrite( errmsg->value, Str_len(errmsg), 1, fp ); #if defined(DOS) || defined(OS2) || defined(WIN32) /* * stdout is open in binary mode, so we need to add the * extra CR to the end of the line. */ fputc( REGINA_CR, fp ); #endif fputc( REGINA_EOL, fp ); } /* * Display the sub-error text if there is one. */ if ( ( errorno <= ERR_MAX_NUMBER ) && suberrorno && suberror_streng ) { if ( TSD->systeminfo->hooks & HOOK_MASK( HOOK_STDERR ) ) ok = hookup_output(TSD, HOOK_STDERR, suberror_streng ) == HOOK_GO_ON; if ( ok == HOOK_GO_ON ) { fwrite( suberror_streng->value, Str_len(suberror_streng), 1, fp ); #if defined(DOS) || defined(OS2) || defined(WIN32) /* * stdout is open in binary mode, so we need to add the * extra CR to the end of the line. */ fputc( REGINA_CR, fp ); #endif fputc( REGINA_EOL, fp ); } } if ( ok == HOOK_GO_ON ) fflush( fp ); if ( suberror_streng ) Free_stringTSD( suberror_streng ); Free_stringTSD( errmsg ); /* clean up internal buffers */ clear_errortext_buffers( TSD ); not_hookable: if ( TSD->systeminfo->script_exit ) { TSD->instore_is_errorfree = 0; if ( et != NULL ) { /* * The error handler must inhibit the cleanup of errornum. */ et->errornum->len = sprintf( et->errornum->value, "%d", -errorno ); jump_script_exit( TSD, et->errornum ); } } CloseOpenFiles( TSD, fpdRETAIN ); free_orphaned_libs( TSD ); #ifdef VMS jump_interpreter_exit( TSD, EXIT_SUCCESS ); #else jump_interpreter_exit( TSD, errorno ); #endif } /* This function is called by the parser (syntactical interpreter) if an error * occurs. */ void __reginaerror(char *dummy) { /* We ignore the message although it may contain useful informations. */ return ; } static streng *read_index_header( const tsd_t *TSD, char *errfn, int native_language, FILE **fp, int *number_messages, int *file_lang, int *number_prefix_messages ) { err_tsd_t *et; et = (err_tsd_t *)TSD->err_tsd; /* * Read the language file header... */ *fp = fopen( errfn, "rb" ); if ( *fp == NULL ) { return simple_msg( TSD, erropen, errfn ); } if ( fread( &et->number_messages, sizeof(unsigned int), 1, *fp ) != 1 ) { fclose( *fp ); return simple_msg( TSD, errread, errfn ); } if ( fread( file_lang, sizeof(unsigned int), 1, *fp ) != 1 ) { fclose( *fp ); return simple_msg( TSD, errread, errfn ); } if ( fread( &et->number_prefix_messages, sizeof(unsigned int), 1, *fp ) != 1 ) { fclose( *fp ); return simple_msg( TSD, errread, errfn ); } return NULL; } static streng *read_index_file( const tsd_t *TSD, char *errfn, int native_language, int language_file, FILE **fp, struct textindex *tmi, struct textindex *tpi ) { err_tsd_t *et; streng *ptr; int file_lang; et = (err_tsd_t *)TSD->err_tsd; /* * Read the language file header... */ if ( ( ptr = read_index_header( TSD, errfn, native_language, fp, &et->number_messages, &file_lang, &et->number_prefix_messages ) ) != NULL ) { et->number_messages = 0; return ptr; } /* * Eunsure that the number of messages in the file matches the number defined as * NUMBER_ERROR_MESSAGES in rexxmsg.h */ if ( et->number_messages != NUMBER_ERROR_MESSAGES ) { fclose( *fp ); et->number_messages = 0; return simple_msg( TSD, errcount, errfn ); } if ( fread( tmi, sizeof(struct textindex), NUMBER_ERROR_MESSAGES, *fp ) != NUMBER_ERROR_MESSAGES ) { fclose( *fp ); et->number_messages = 0; return simple_msg( TSD, errread, errfn ); } /* * Eunsure that the number of prefix messages in the file matches the number defined as * NUMBER_PREFIX_MESSAGES in rexxmsg.h */ if ( et->number_prefix_messages != NUMBER_PREFIX_MESSAGES ) { fclose( *fp ); et->number_prefix_messages = 0; return simple_msg( TSD, errcount, errfn ); } if ( fread( tpi, sizeof(struct textindex), NUMBER_PREFIX_MESSAGES, *fp ) != NUMBER_PREFIX_MESSAGES ) { fclose( *fp ); et->number_prefix_messages = 0; return simple_msg( TSD, errread, errfn ); } return NULL; } /* * Called the first time we need to access an error message * Determines which language file to open and read (always does English as well) * Returns NULL on success, otherwise a pointer to an error message */ static streng *get_message_indexes( const tsd_t *TSD ) { streng *err; char *ptr; char fn[REXX_PATH_MAX+20]; err_tsd_t *et; char *errpath=NULL; #if defined(__EPOC32__) || defined(__WINS__) FILE *fp; int number_messages, file_lang. number_prefix_messages; struct stat buffer ; #else int i, found=0; #endif et = (err_tsd_t *)TSD->err_tsd; #if defined(__EPOC32__) || defined(__WINS__) /* * Open the default.mtb and read the language type from it. */ errpath = "c:\\system\\apps\\reginarexx"; sprintf( fn, "%s\\default.mtb", errpath ); /* * If there is no default.mtb file, then default to English */ if ( stat( fn, &buffer ) != 0 ) { et->native_language = LANGUAGE_ENGLISH; return NULL; } /* * We do have a default.mtb file, so read it to determine the language */ if ( ( err = read_index_header( TSD, fn, LANGUAGE_ENGLISH, &fp, &number_messages, &file_lang, &number_prefix_messgaes ) ) != NULL ) { et->number_messages = et->number_prefix_messages = 0; return err; } if ( fp ) fclose( fp ); et->native_language = file_lang; #else ptr = getenv( "REGINA_LANG" ); if ( ptr == NULL || strlen( ptr) == 0 ) { et->native_language = LANGUAGE_ENGLISH; } else { /* * REGINA_LANG may have a comma separated default locale appended. */ int len = strcspn( ptr, "," ); for ( i = 0; errlang[i] != NULL; i++ ) { if ( ( (int) strlen( errlang[i] ) == len ) && ( memcmp( ptr, errlang[i], len ) == 0 ) ) { et->native_language = i; found = 1; break; } } if ( !found ) { err = get_buffer( TSD, 40 + len ); Str_len( err ) = sprintf( err->value, "Unsupported native language \"%.*s\"", len, ptr ); return err; } } if ( et->native_language != LANGUAGE_ENGLISH ) { errpath = getenv( "REGINA_LANG_DIR" ); if ( errpath == NULL ) { # if defined(REGINA_SHARE_DIRECTORY) errpath = REGINA_SHARE_DIRECTORY; # else return simple_msg( TSD, "%s", "Unable to determine where Regina language files (*.mtb) are located. Set REGINA_LANG_DIR." ); # endif } else if ( strlen( errpath ) > REXX_PATH_MAX ) return simple_msg( TSD, "Length of \"%s\" exceeds the path's maximum", errpath ); } #endif /* * Now read the native language file. If the native language is * English, don't do anything. */ if ( et->native_language != LANGUAGE_ENGLISH) { #if defined(__EPOC32__) || defined(__WINS__) sprintf( fn, "%s\\default.mtb", errpath ); #else sprintf( fn, "%s%c%s.mtb", errpath, FILE_SEPARATOR, errlang[et->native_language] ); #endif if ( ( err = read_index_file( TSD, fn, et->native_language, et->native_language, &et->nls_fp, (struct textindex *)&et->nls_tmi,(struct textindex *)&et->nls_tpi ) ) != NULL ) return err; } return NULL; } const streng *errortext( const tsd_t *TSD, int errorno, int suberrorno, int request_english, int apply_inserts ) { int low=0, mid=0, end=1, up, have_inserts=0, num_inserts=0; int this_errorno, this_suberrorno; err_tsd_t *et; streng *ptr=NULL,*h; const char *errfn,*embedded; char *ins; char *insert[5]; /* maximum of 5 inserts allowed for any one message */ int is_fmt=1; /* * If the supplied errorno is > 100 (the internal limit for interpreter * errors), assume that a system error message is required. */ if (errorno>100) { return simple_msg( TSD, "%s", strerror(errorno-100) ); } et = (err_tsd_t *)TSD->err_tsd; #if defined(__EPOC32__) || defined(__WINS__) errfn="default"; #else errfn=errlang[et->native_language]; #endif /* * The first time this is called, determine the language and read the message file * indexes into memory from the message file. */ if ( et->number_messages == 0 ) { if ( ( ptr = get_message_indexes( TSD ) ) != NULL ) { /* * Corrupt or missing language file. Prepend the returned message to the * embedded error message format. */ embedded = get_embedded_text_message( errorno, suberrorno ); h = get_buffer( TSD, Str_len( ptr ) + strlen( embedded ) + 6 ); Str_catstrTSD( h, "(" ); Str_catTSD( h, ptr ); Str_catstrTSD( h, ") " ); Str_catstrTSD( h, embedded ); h->value[Str_len( h )] = '\0'; ptr = h; } } /* * If we don't already have an error message, * and we are explicitly requesting an english message, or the native * language is English, then simply get the message from the internal * array. */ if ( !ptr ) { if ( request_english || et->native_language == LANGUAGE_ENGLISH ) { ptr = simple_msg( TSD, "%s", get_embedded_text_message( errorno, suberrorno ) ); } else { up = et->number_messages-1; while ((end)&&(up>=low)) { mid = (up+low)/2 ; this_errorno = et->nls_tmi[mid].errorno; this_suberrorno = et->nls_tmi[mid].suberrorno; if ( errorno == this_errorno && suberrorno == this_suberrorno ) { end = 0; break; } if ( ( errorno > this_errorno ) || ( errorno == this_errorno && suberrorno > this_suberrorno ) ) low = mid + 1; else up = mid - 1; } if (end) { /* * We couldn't find our message... */ embedded = get_embedded_text_message( errorno, suberrorno ); ptr = simple_msg( TSD, errmissing, errfn ); h = get_buffer( TSD, Str_len( ptr ) + strlen( embedded ) + 6 ); Str_catstrTSD( h, "(" ); Str_catTSD( h, ptr ); Str_catstrTSD( h, ") " ); Str_catstrTSD( h, embedded ); h->value[Str_len( h )] = '\0'; ptr = h; } else { ptr = get_text_message( TSD, et->nls_fp, et->nls_tmi[mid].fileoffset, et->nls_tmi[mid].textlength, errorno, suberrorno, &is_fmt ); if ( !is_fmt ) { embedded = get_embedded_text_message( errorno, suberrorno ); h = get_buffer( TSD, Str_len( ptr ) + strlen( embedded ) + 6 ); Str_catstrTSD( h, "(" ); Str_catTSD( h, ptr ); Str_catstrTSD( h, ") " ); Str_catstrTSD( h, embedded ); h->value[Str_len( h )] = '\0'; ptr = h; } } } } for ( low = 0; low < (int) Str_len( ptr ); low++ ) { if ( ptr->value[low] == '|' ) { ptr->value[low] = '\0'; Str_len( ptr ) = low; have_inserts = 1; break; } } /* * If we need to apply insert, then: * - adjust the returned fmt string replacing %c, %d, %x with %s * - iterate through the inserts ( ptr+low+1 ) */ if ( apply_inserts && have_inserts ) { /* * The code below makes several assumptions about the format * of each message. All assumptions are based on having checked * the format of the messages using the checkmts.rexx script. */ for ( end = 0; end < Str_len( ptr ); end++ ) { if ( ptr->value[end] == '%' ) { switch( ptr->value[end+1] ) /* assumes no message ends in % */ { case 's': num_inserts++; break; case 'c': case 'x': case 'd': ptr->value[end+1] = 's'; num_inserts++; break; default: break; } } } ins = ptr->value+low+1; insert[0] = ins; low = strlen( ins ); for ( mid = 0,end = 0; end < low; end++ ) { if ( ins[end] == ',' ) { ins[end] = '\0'; insert[++mid] = ins+end+1; } } h = get_buffer( TSD, Str_len( ptr ) + low + 1 ); switch( num_inserts ) { case 1: Str_len( h ) = sprintf( h->value, ptr->value, insert[0] ); break; case 2: Str_len( h ) = sprintf( h->value, ptr->value, insert[0], insert[1] ); break; case 3: Str_len( h ) = sprintf( h->value, ptr->value, insert[0], insert[1], insert[2] ); break; case 4: Str_len( h ) = sprintf( h->value, ptr->value, insert[0], insert[1], insert[2], insert[3] ); break; case 5: Str_len( h ) = sprintf( h->value, ptr->value, insert[0], insert[1], insert[2], insert[3], insert[4] ); break; } ptr = h; } return ptr; } #ifndef NDEBUG const char *getsym( int numb ) { char *symb=NULL ; switch (numb) { case X_NULL: symb="Null statement" ; break ; case X_PROGRAM: symb="Program" ; break ; case X_STATS: symb="Statements" ; break ; case X_COMMAND: symb="External command" ; break ; case X_ADDR_V: symb="ADDRESS (value) statement" ; break ; case X_ADDR_S: symb="ADDRESS" ; break ; case X_ADDR_N: symb="ADDRESS (normal) statement" ; break ; case X_CALL: symb="CALL statement" ; break ; case X_DO: symb="DO statement" ; break ; case X_REP: symb="Repetitor in DO" ; break ; case X_REP_FOREVER: symb="Forever in DO" ; break ; case X_DO_TO: symb="Upper limit in DO" ; break ; case X_DO_BY: symb="Step-size in DO" ; break ; case X_DO_FOR: symb="Max number in DO" ; break ; case X_WHILE: symb="WHILE expr in DO" ; break ; case X_UNTIL: symb="UNTIL expr in DO" ; break ; case X_DROP: symb="DROP statement" ; break ; case X_EXIT: symb="EXIT statement" ; break ; case X_IF: symb="IF statement" ; break ; case X_IPRET: symb="INTERPRET statement" ; break ; case X_ITERATE: symb="ITERATE statement" ; break ; case X_LABEL: symb="Label specification" ; break ; case X_LEAVE: symb="LEAVE statement" ; break ; case X_NUM_D: symb="NUMERIC DIGIT statement" ; break ; case X_NUM_F: symb="NUMERIC FORM statement" ; break ; case X_NUM_FUZZ: symb="NUMERIC FUZZ statement" ; break ; case X_NUM_SCI: symb="Scientific numeric form" ; break ; case X_NUM_ENG: symb="Engeenering scientific form" ; break ; case X_PARSE: symb="PARSE statement" ; break ; case X_PARSE_ARG: symb="PARSE ARG atatement" ; break ; case X_PARSE_EXT: symb="External parsing" ; break ; case X_PARSE_PULL: symb="Parse pull" ; break ; case X_PARSE_SRC: symb="Parse source" ; break ; case X_PARSE_VAR: symb="Parse variable" ; break ; case X_PARSE_VAL: symb="Parse value" ; break ; case X_PARSE_VER: symb="Parse version" ; break ; case X_PROC: symb="PROCEDURE statement" ; break ; case X_PULL: symb="PULL statement" ; break ; case X_PUSH: symb="PUSH statement" ; break ; case X_QUEUE: symb="QUEUE statement" ; break ; case X_RETURN: symb="RETURN statement" ; break ; case X_SAY: symb="SAY statement" ; break ; case X_SELECT: symb="SELECT statement" ; break ; case X_WHENS: symb="WHEN connector" ; break ; case X_WHEN: symb="WHEN clause" ; break ; case X_OTHERWISE: symb="OTHERWISE clause" ; break ; case X_SIG_VAL: symb="SIGNAL VALUE statement" ; break ; case X_SIG_LAB: symb="SIGNAL (label) statement" ; break ; case X_SIG_SET: symb="SIGNAL (setting) statement" ; break ; case X_ON: symb="Setting is ON" ; break ; case X_OFF: symb="Setting is OFF" ; break ; case X_S_ERROR: symb="ERROR option" ; break ; case X_S_HALT: symb="HALT option" ; break ; case X_S_NOVALUE: symb="NOVALUE option" ; break ; case X_S_SYNTAX: symb="SYNTAX option" ; break ; case X_TRACE: symb="TRACE statement" ; break ; case X_UPPER_VAR: symb="UPPER statement" ; break ; case X_ASSIGN: symb="Assignment" ; break ; case X_LOG_NOT: symb="Logical NOT" ; break ; case X_PLUSS: symb="Plus operator" ; break ; case X_EQUAL: symb="Equal operator" ; break ; case X_MINUS: symb="Minus operator" ; break ; case X_MULT: symb="Multiplication operator" ; break ; case X_DEVIDE: symb="Division operator" ; break ; case X_MODULUS: symb="Modulus operator" ; break ; case X_LOG_OR: symb="Logical or" ; break ; case X_LOG_AND: symb="Logical and" ; break ; case X_LOG_XOR: symb="Logical xor" ; break ; case X_EXP: symb="Exponent operator" ; break ; case X_CONCAT: symb="String concatenation" ; break ; case X_SPACE: symb="Space separator" ; break ; case X_GTE: symb="Greater than or equal operator" ; break ; case X_LTE: symb="Less than or equal operator" ; break ; case X_GT: symb="Greater than operator" ; break ; case X_LT: symb="Less than operator" ; break ; case X_DIFF: symb="Different operator" ; break ; case X_SIM_SYMBOL: symb="Simple symbol" ; break ; case X_CON_SYMBOL: symb="Constant symbol" ; break ; case X_STRING: symb="Constant string" ; break ; case X_U_MINUS: symb="Unary minus" ; break ; case X_S_EQUAL: symb="String equal operator" ; break ; case X_S_DIFF: symb="String different operator" ; break ; case X_INTDIV: symb="Integer division" ; break ; case X_EX_FUNC: symb="External function call" ; break ; case X_IN_FUNC: symb="Internal function call" ; break ; case X_TPL_SOLID: symb="Solid point in template" ; break ; case X_TPL_MVE: symb="Constant pattern" ; break ; case X_TPL_VAR: symb="Variable pattern" ; break ; case X_TPL_SYMBOL: symb="Variable in template" ; break ; case X_TPL_POINT: symb="Placeholder in template" ; break ; case X_NEG_OFFS: symb="Negative offset" ; break ; case X_POS_OFFS: symb="Positive offset" ; break ; case X_ABS_OFFS: symb="Absolute offset" ; break ; case X_EXPRLIST: symb="Expression connector" ; break ; case X_S_NOTREADY: symb="NOTREADY option" ; break ; case X_S_FAILURE: symb="FAILURE option" ; break ; case X_END: symb="End statement" ; break ; case X_CALL_SET: symb="CALL specification" ; break ; case X_NO_OTHERWISE: symb="No otherwise statement" ; break ; case X_IND_SYMBOL: symb="Indirect symbol" ; break ; case X_IS_INTERNAL: symb="Internal function" ; break ; case X_IS_BUILTIN: symb="Builtin function" ; break ; case X_IS_EXTERNAL: symb="External function" ; break ; case X_CTAIL_SYMBOL: symb="Constant tail symbol" ; break ; case X_VTAIL_SYMBOL: symb="Variable tail symbol" ; break ; case X_HEAD_SYMBOL: symb="Compound variable symbol" ; break ; case X_STEM_SYMBOL: symb="Stem variable symbol" ; break ; case X_SEQUAL: symb="Strictly equal operator" ; break ; case X_SDIFF: symb="Strictly different operator" ; break ; case X_SGT: symb="Strictly greater than operator" ; break ; case X_SGTE: symb="Strictly greater than or equal operator" ; break ; case X_SLT: symb="Strictly less than operator" ; break ; case X_SLTE: symb="Strictly less than or equal operator" ; break ; case X_NEQUAL: symb="Not equal operator" ; break ; case X_NDIFF: symb="Not different operator" ; break ; case X_NGT: symb="Not greater than operator" ; break ; case X_NGTE: symb="Not greater than or equal operator" ; break ; case X_NLT: symb="Not less than operator" ; break ; case X_NLTE: symb="Not less than or equal operator" ; break ; case X_NASSIGN: symb="Numeric Assignment" ; break ; case X_CEXPRLIST: symb="Expression list" ; break ; case X_U_PLUSS: symb="Unary Plus" ; break ; case X_OPTIONS: symb="OPTIONS statement" ; break ; case X_NUM_V: symb="NUMERIC FORM VALUE statement" ; break ; case X_NUM_DDEF: symb="NUMERIC DIGITS statement" ; break ; case X_NUM_FDEF: symb="NUMERIC FUZZ statement" ; break ; case X_NUM_FRMDEF: symb="NUMERIC FORM statement" ; break ; case X_S_NGT: symb="Strictly not greater than operator" ; break ; case X_S_NLT: symb="Strictly not less than operator" ; break ; case X_S_GT: symb="Strictly greater than operator" ; break ; case X_S_GTE: symb="Strictly greater than or equal operator" ; break ; case X_S_LT: symb="Strictly less than operator" ; break ; case X_S_LTE: symb="Strictly less than or equal operator" ; break ; case X_ADDR_WITH: symb="ADDRESS WITH option list" ; break ; case X_S_LOSTDIGITS: symb="LOSTDIGITS option" ; break ; case X_DO_EXPR: symb="Upper limit in DO" ; break ; case X_PLUSASSIGN: symb="Plus assignemnt operator" ; break ; case X_MINUSASSIGN: symb="Minus assignemnt operator" ; break ; case X_MULTASSIGN: symb="Multiplication assignemnt operator" ; break ; case X_DIVASSIGN: symb="Division assignemnt operator" ; break ; case X_INTDIVASSIGN: symb="Integer division assignemnt operator" ; break ; case X_MODULUSASSIGN: symb="Modulus assignemnt operator" ; break ; case X_ORASSIGN: symb="Logical OR assignemnt operator" ; break ; case X_XORASSIGN: symb="Logical XOR assignemnt operator" ; break ; case X_ANDASSIGN: symb="Logical AND assignemnt operator" ; break ; case X_CONCATASSIGN: symb="Concatenation assignemnt operator" ; break ; default: symb="Unrecognized value" ; } return symb ; } #endif /* !NDEBUG */