cutil/danerror.cpp File Reference

#include "general.h"
#include "danerror.h"
#include "callcpp.h"
#include "globaloc.h"
#include <stdio.h>
#include <setjmp.h>

Go to the source code of this file.

Defines

• #define ERRORTRAPDEPTH   1000
• #define MAXTRAPDEPTH   100

Functions

• void DoError (int Error, const char *Message)

  Prints the specified error message to stderr & jumps to the current error trap.
  

• jmp_buf & PushErrorTrap (VOID_PROC Procedure)

  Pushes a new error trap onto the top of the error trap stack.
  

• void ReleaseErrorTrap ()

  Removes the current error trap from the error trap stack, thus returning control to the previous error trap.
  

Variables

• static INT32 CurrentTrapDepth = 0
• static jmp_buf ErrorTrapStack [MAXTRAPDEPTH]
• static VOID_PROC ProcTrapStack [MAXTRAPDEPTH]

---

Define Documentation

#define ERRORTRAPDEPTH   1000

Definition at line 36 of file danerror.cpp.

Referenced by PushErrorTrap().

#define MAXTRAPDEPTH   100

Note:

File: danerror.cpp
Routines for managing error trapping

Author:

Dan Johnson

Date:

3/17/89, DSJ, Created. 20/4/94, SPC, Modified

 **	(c) Copyright Hewlett-Packard Company, 1988.
 ** Licensed under the Apache License, Version 2.0 (the "License");
 ** you may not use this file except in compliance with the License.
 ** You may obtain a copy of the License at
 ** http://www.apache.org/licenses/LICENSE-2.0
 ** Unless required by applicable law or agreed to in writing, software
 ** distributed under the License is distributed on an "AS IS" BASIS,
 ** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 ** See the License for the specific language governing permissions and
 ** limitations under the License.

Definition at line 34 of file danerror.cpp.

Referenced by PushErrorTrap().

---

Function Documentation

void DoError	(	int	Error,
		const char *	Message
	)

Prints the specified error message to stderr & jumps to the current error trap.

Parameters:

	Error	Error number which is to be trapped
	Message	Pointer to a string to be printed as an error message

Note:

Globals:

• ErrorTrapStack Stack of error traps
• CurrentTrapDepth Number of traps on the stack

Returns:

none (does not return)

If the error trap stack is empty, the calling program is terminated with a fatal error message.

Note:

Exceptions: Empty error trap stack terminates the calling program.

Date:

4/3/89, DSJ, Created.

Definition at line 84 of file danerror.cpp.

References assert(), cprintf(), CurrentTrapDepth, DO_NOTHING, ErrorTrapStack, FALSE, NULL, ProcTrapStack, and signal_termination_handler().

Referenced by Efopen(), Efree(), Emalloc(), Erealloc(), ExtractorStub(), FillAmbigTable(), HeapPush(), HeapStore(), MakeSample(), memalloc_p(), memfree(), NameToChar(), PushErrorTrap(), ReadCharDescription(), ReadFeature(), ReadFeatureSet(), ReadNFloats(), ReadParamDesc(), ReadProtoStyle(), ReadPrototype(), ReadSampleSize(), and ShortNameToFeatureType().

                                             { 
  if (Message != NULL) {
    cprintf ("\nError: %s!\n", Message);
  }

  if (CurrentTrapDepth <= 0) {
    cprintf ("\nFatal error: No error trap defined!\n");

    /* SPC 20/4/94
       There used to be a call to abort() here. I've changed it to call into the
       C++ error code to generate a meaningful status code
     */
    signal_termination_handler(Error); 
  }

  if (ProcTrapStack[CurrentTrapDepth - 1] != DO_NOTHING)
    (*ProcTrapStack[CurrentTrapDepth - 1]) ();

  longjmp (ErrorTrapStack[CurrentTrapDepth - 1], 1);
  assert(FALSE); 
}                                /* DoError */

jmp_buf& PushErrorTrap

(

VOID_PROC

Procedure

)

Pushes a new error trap onto the top of the error trap stack.

Parameters:

Procedure

Trap procedure to execute

Note:

Globals:

• ErrorTrapStack Stack of error traps
• CurrentTrapDepth Number of traps on the stack

Returns:

Pointer to a new error trap buffer

This new error trap can then be used in a call to setjmp. This trap is then in effect until ReleaseErrorTrap is called.

WARNING: a procedure that calls PushErrorTrap should never exit before calling ReleaseErrorTrap.

Note:

Exceptions: Traps an error if the error trap stack is already full

Date:

3/17/89, DSJ, Created. 9/12/90, DSJ, Added trap procedure parameter.

Definition at line 129 of file danerror.cpp.

References CurrentTrapDepth, DoError(), ERRORTRAPDEPTH, ErrorTrapStack, MAXTRAPDEPTH, and ProcTrapStack.

                                            { 
  if (CurrentTrapDepth >= MAXTRAPDEPTH)
    DoError (ERRORTRAPDEPTH, "Error trap depth exceeded");
  ProcTrapStack[CurrentTrapDepth] = Procedure;
  return ErrorTrapStack[CurrentTrapDepth++];

}                                /* PushErrorTrap */

void ReleaseErrorTrap

(

)

Removes the current error trap from the error trap stack, thus returning control to the previous error trap.

Note:

Globals: CurrentTrapDepth number of traps on the stack

Returns:

none

If the error trap stack is empty, nothing is done.

Note:

Exceptions: None

Date:

4/3/89, DSJ, Created.

Definition at line 60 of file danerror.cpp.

References CurrentTrapDepth.

Referenced by cc_recog().

                        { 
  if (CurrentTrapDepth > 0) {
    CurrentTrapDepth--;
  }
}                                /* ReleaseErrorTrap */

---

Variable Documentation

INT32 CurrentTrapDepth = 0 [static]

Definition at line 43 of file danerror.cpp.

Referenced by DoError(), PushErrorTrap(), and ReleaseErrorTrap().

jmp_buf ErrorTrapStack[MAXTRAPDEPTH] [static]

Definition at line 41 of file danerror.cpp.

Referenced by DoError(), and PushErrorTrap().

VOID_PROC ProcTrapStack[MAXTRAPDEPTH] [static]

Definition at line 42 of file danerror.cpp.

Referenced by DoError(), and PushErrorTrap().

---