source: main/trunk/greenstone2/build-src/packages/isis-gdl/IErrors.cpp@ 26670

/**********************************************************************
 *
 * IErrors.cpp
 * Copyright (C) 2003  UNESCO
 *
 * A component of the Greenstone digital library software
 * from the New Zealand Digital Library Project at the
 * University of Waikato, New Zealand.
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program 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 General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 *
 *********************************************************************/

////////////////////////////////////////////////////////////////////////////////////
// Error.cpp

// #include "stdafx.h"
// The Error functions and classes are used to catch and/or
// record database exceptions that occur during run-time. This
// implementation can be used with or without C++ built-in exception
// handling. If C++ exception handling is not enabled with the
// __CPP_EXCEPTIONS__ macro, then the vbDatabaseError enumerated
// constants can be used to record database errors.
#include "IErrors.h"

// NOTE: This array must contain the same number of exceptions as the
// IsisError enumeration. 
const int MaxExceptionMessages = 57;
const char* isisExceptionMessages[MaxExceptionMessages] = {
  "Database exception: No exception reported",               // None
  "Database exception: Invalid error code reported",         // Invalid
  "Database exception: Memory exhausted",
  "Database exception: Error opening xrf file",
  "Database exception: Error creating xrf file",
  "Database exception: Error reading xrf file",
  "Database exception: Error writing xrf file",
  "Database exception: xrf file is corrupted",
  "Database exception: xrf file, invalid block",
  "Database exception: xrf file, invalid status",
  "Database exception: Error creating an existing mf file",
  "Database exception: Error opening mf file",
  "Database exception: Error opening mf file",
  "Database exception: Error creating mf file",
  "Database exception: Error reading mf file",
  "Database exception: Error writing mf file",
  "Database exception: Access Violation",                    // AccessViolation
  "Database exception: Assertion failed",                    // AssertError
  "Database exception: Wrong object type",                   // BadClassID
  "Database exception: Bad object address",                  // BadObjectAddress
  "Database exception: Bad reference",                       // BadReference
  "Database exception: Cache full",                          // CacheFull
  "Database exception: Checksum error",                      // ChecksumError
  "Database exception: Divide by zero error",                // DivideByZero
  "Database exception: Unexpected end of file was reached",  // EOFError
  "Database exception: Error closing file",                  // FileCloseError
  "Database exception: File is corrupt",                     // FileCorrupt
  "Database exception: Error creating file",                 // CreationError
  "Database exception: File already exists",                 // FileExists
  "Database exception: Trying to use a closed file",         // FileNotOpenError
  "Database exception: File not ready for reading/writing",  // FileNotReady
  "Database exception: Could not write to file",             // NotWriteable
  "Database exception: Error opening file",                  // FileOpenError
  "Database exception: Cannot obtain a file position",       // FilePostionError
  "Database exception: Error reading from file",             // FileReadError
  "Database exception: Error seeking in file",               // FileSeekError
  "Database exception: Error writing to file",               // FileWriteError
  "Database exception: No database open",                    // NoDatabaseOpen
  "Database exception: No such file exists",                 // NoFileExists
  "Database exception: No objects exist",                    // NoObjectsExist
  "Database exception: Accessing a null pointer",            // NullPtr
  "Database exception: Object already exists",               // ObjectExists
  "Database exception: Another object is referencing this file", // Referenced
  "Database exception: Math overflow error",                 // OverFlow
  "Database exception: Parse error",                         // ParseError
  "Database exception: Invalid path",                        // PathError
  "Database exception: Trying to write to a read-only file", // ReadOnlyFile
  "Database exception: Stack empty",                         // StackEmpty
  "Database exception: Stack full",                          // StackFull
  "Database exception: Synchronization Error",               // SyncError    
  "Database exception: Math under-flow error",               // UnderFlow
  "Database exception: Wrong file type",                     // WrongFileType

  // Persistent lock error messages
  "Database exception: Invalid lock type specified",          // LOCK_TYPE
  "Database exception: Cannot access the file lock header",   // FLK_ACCESS
  "Database exception: Cannot lock the file",                 // FLK_ERROR
  "Database exception: Cannot access the record lock header", // RLK_ACCESS
  "Database exception: Cannot lock the specified record"      // RLK_ERROR
};

const char *isisExceptionMessage(IsisError err)
// Standalone function that returns a null terminated string that can
// be use to log or print a database exception message.
{
  int error = (int)err;
  if(error > MaxExceptionMessages) error = ISIS_INVALID_CODE;

  // Find the corresponding message in the exception array
  return isisExceptionMessages[error];
}