exiv2/src/error.cpp

// SPDX-License-Identifier: GPL-2.0-or-later

// included header files
#include "error.hpp"
#include "types.hpp"
#include "i18n.h"                // NLS support.

// + standard includes
#include <iostream>
#include <cassert>

// *****************************************************************************
namespace {

    //! Helper structure defining an error message.
    struct ErrMsg {
        //! Comparison operator
        bool operator==(Exiv2::ErrorCode code) const { return code_ == code; }

        Exiv2::ErrorCode code_;                              //!< Error code
        const char* message_;                   //!< Error message
    };

    //! Complete list of Exiv2 exception error messages
    const ErrMsg errList[] = {
        { Exiv2::ErrorCode::kerGeneralError,
          N_("Error %0: arg2=%2, arg3=%3, arg1=%1.") },
        { Exiv2::ErrorCode::kerSuccess,
          N_("Success") },
        { Exiv2::ErrorCode::kerErrorMessage,
          "%1" }, // %1=error message
        { Exiv2::ErrorCode::kerCallFailed,
          "%1: Call to `%3' failed: %2" }, // %1=path, %2=strerror, %3=function that failed
        { Exiv2::ErrorCode::kerNotAnImage,
          N_("This does not look like a %1 image") }, // %1=Image type
        { Exiv2::ErrorCode::kerInvalidDataset,
          N_("Invalid dataset name '%1'") }, // %1=dataset name
        { Exiv2::ErrorCode::kerInvalidRecord,
          N_("Invalid record name '%1'") }, // %1=record name
        { Exiv2::ErrorCode::kerInvalidKey,
          N_("Invalid key '%1'") }, // %1=key
        { Exiv2::ErrorCode::kerInvalidTag,
          N_("Invalid tag name or ifdId `%1', ifdId %2") }, // %1=tag name, %2=ifdId
        { Exiv2::ErrorCode::kerValueNotSet,
          N_("Value not set") },
        { Exiv2::ErrorCode::kerDataSourceOpenFailed,
          N_("%1: Failed to open the data source: %2") }, // %1=path, %2=strerror
        { Exiv2::ErrorCode::kerFileOpenFailed,
          N_("%1: Failed to open file (%2): %3") }, // %1=path, %2=mode, %3=strerror
        { Exiv2::ErrorCode::kerFileContainsUnknownImageType,
          N_("%1: The file contains data of an unknown image type") }, // %1=path
        { Exiv2::ErrorCode::kerMemoryContainsUnknownImageType,
          N_("The memory contains data of an unknown image type") },
        { Exiv2::ErrorCode::kerUnsupportedImageType,
          N_("Image type %1 is not supported") }, // %1=image type
        { Exiv2::ErrorCode::kerFailedToReadImageData,
          N_("Failed to read image data") },
        { Exiv2::ErrorCode::kerNotAJpeg,
          N_("This does not look like a JPEG image") },
        { Exiv2::ErrorCode::kerFailedToMapFileForReadWrite,
          N_("%1: Failed to map file for reading and writing: %2") }, // %1=path, %2=strerror
        { Exiv2::ErrorCode::kerFileRenameFailed,
          N_("%1: Failed to rename file to %2: %3") }, // %1=old path, %2=new path, %3=strerror
        { Exiv2::ErrorCode::kerTransferFailed,
          N_("%1: Transfer failed: %2") }, // %1=path, %2=strerror
        { Exiv2::ErrorCode::kerMemoryTransferFailed,
          N_("Memory transfer failed: %1") }, // %1=strerror
        { Exiv2::ErrorCode::kerInputDataReadFailed,
          N_("Failed to read input data") },
        { Exiv2::ErrorCode::kerImageWriteFailed,
          N_("Failed to write image") },
        { Exiv2::ErrorCode::kerNoImageInInputData,
          N_("Input data does not contain a valid image") },
        { Exiv2::ErrorCode::kerInvalidIfdId,
          N_("Invalid ifdId %1") }, // %1=ifdId
        { Exiv2::ErrorCode::kerValueTooLarge,
          N_("Entry::setValue: Value too large (tag=%1, size=%2, requested=%3)") }, // %1=tag, %2=dataSize, %3=required size
        { Exiv2::ErrorCode::kerDataAreaValueTooLarge,
          N_("Entry::setDataArea: Value too large (tag=%1, size=%2, requested=%3)") }, // %1=tag, %2=dataAreaSize, %3=required size
        { Exiv2::ErrorCode::kerOffsetOutOfRange,
          N_("Offset out of range") },
        { Exiv2::ErrorCode::kerUnsupportedDataAreaOffsetType,
          N_("Unsupported data area offset type") },
        { Exiv2::ErrorCode::kerInvalidCharset,
          N_("Invalid charset: `%1'") }, // %1=charset name
        { Exiv2::ErrorCode::kerUnsupportedDateFormat,
          N_("Unsupported date format") },
        { Exiv2::ErrorCode::kerUnsupportedTimeFormat,
          N_("Unsupported time format") },
        { Exiv2::ErrorCode::kerWritingImageFormatUnsupported,
          N_("Writing to %1 images is not supported") }, // %1=image format
        { Exiv2::ErrorCode::kerInvalidSettingForImage,
          N_("Setting %1 in %2 images is not supported") }, // %1=metadata type, %2=image format
        { Exiv2::ErrorCode::kerNotACrwImage,
          N_("This does not look like a CRW image") },
        { Exiv2::ErrorCode::kerFunctionNotSupported,
          N_("%1: Not supported") }, // %1=function
        { Exiv2::ErrorCode::kerNoNamespaceInfoForXmpPrefix,
          N_("No namespace info available for XMP prefix `%1'") }, // %1=prefix
        { Exiv2::ErrorCode::kerNoPrefixForNamespace,
          N_("No prefix registered for namespace `%2', needed for property path `%1'") }, // %1=namespace
        { Exiv2::ErrorCode::kerTooLargeJpegSegment,
          N_("Size of %1 JPEG segment is larger than 65535 bytes") }, // %1=type of metadata (Exif, IPTC, JPEG comment)
        { Exiv2::ErrorCode::kerUnhandledXmpdatum,
          N_("Unhandled Xmpdatum %1 of type %2") }, // %1=key, %2=value type
        { Exiv2::ErrorCode::kerUnhandledXmpNode,
          N_("Unhandled XMP node %1 with opt=%2") }, // %1=key, %2=XMP Toolkit option flags
        { Exiv2::ErrorCode::kerXMPToolkitError,
          N_("XMP Toolkit error %1: %2") }, // %1=XMP_Error::GetID(), %2=XMP_Error::GetErrMsg()
        { Exiv2::ErrorCode::kerDecodeLangAltPropertyFailed,
          N_("Failed to decode Lang Alt property %1 with opt=%2") }, // %1=property path, %3=XMP Toolkit option flags
        { Exiv2::ErrorCode::kerDecodeLangAltQualifierFailed,
          N_("Failed to decode Lang Alt qualifier %1 with opt=%2") }, // %1=qualifier path, %3=XMP Toolkit option flags
        { Exiv2::ErrorCode::kerEncodeLangAltPropertyFailed,
          N_("Failed to encode Lang Alt property %1") }, // %1=key
        { Exiv2::ErrorCode::kerPropertyNameIdentificationFailed,
          N_("Failed to determine property name from path %1, namespace %2") }, // %1=property path, %2=namespace
        { Exiv2::ErrorCode::kerSchemaNamespaceNotRegistered,
          N_("Schema namespace %1 is not registered with the XMP Toolkit") }, // %1=namespace
        { Exiv2::ErrorCode::kerNoNamespaceForPrefix,
          N_("No namespace registered for prefix `%1'") }, // %1=prefix
        { Exiv2::ErrorCode::kerAliasesNotSupported,
          N_("Aliases are not supported. Please send this XMP packet to ahuggel@gmx.net `%1', `%2', `%3'") }, // %1=namespace, %2=property path, %3=value
        { Exiv2::ErrorCode::kerInvalidXmpText,
          N_("Invalid XmpText type `%1'") }, // %1=type
        { Exiv2::ErrorCode::kerTooManyTiffDirectoryEntries,
          N_("TIFF directory %1 has too many entries") }, // %1=TIFF directory name
        { Exiv2::ErrorCode::kerMultipleTiffArrayElementTagsInDirectory,
          N_("Multiple TIFF array element tags %1 in one directory") }, // %1=tag number
        { Exiv2::ErrorCode::kerWrongTiffArrayElementTagType,
          N_("TIFF array element tag %1 has wrong type") }, // %1=tag number
        { Exiv2::ErrorCode::kerInvalidKeyXmpValue,
          N_("%1 has invalid XMP value type `%2'") }, // %1=key, %2=value type
        { Exiv2::ErrorCode::kerInvalidIccProfile,
          N_("Not a valid ICC Profile") },
        { Exiv2::ErrorCode::kerTiffDirectoryTooLarge,
          N_("tiff directory length is too large") },
        { Exiv2::ErrorCode::kerInvalidTypeValue,
          N_("invalid type in tiff structure") },
        { Exiv2::ErrorCode::kerInvalidLangAltValue,
          N_("Invalid LangAlt value `%1'") }, // %1=value
        { Exiv2::ErrorCode::kerInvalidMalloc,
          N_("invalid memory allocation request") },
        { Exiv2::ErrorCode::kerCorruptedMetadata,
          N_("corrupted image metadata") },
        { Exiv2::ErrorCode::kerArithmeticOverflow,
          N_("Arithmetic operation overflow") },
        { Exiv2::ErrorCode::kerMallocFailed,
          N_("Memory allocation failed")}
    };

}  // namespace

// *****************************************************************************
// class member definitions
namespace Exiv2 {

    LogMsg::Level LogMsg::level_ = LogMsg::warn; // Default output level
    LogMsg::Handler LogMsg::handler_ = LogMsg::defaultHandler;

    LogMsg::LogMsg(LogMsg::Level msgType) : msgType_(msgType)
    {}

    LogMsg::~LogMsg()
    {
        if (msgType_ >= level_ && handler_)
            handler_(msgType_, os_.str().c_str());
    }

    std::ostringstream &LogMsg::os() { return os_; }

    void LogMsg::setLevel(LogMsg::Level level) { level_ = level; }

    void LogMsg::setHandler(LogMsg::Handler handler) { handler_ = handler; }

    LogMsg::Level LogMsg::level() { return level_; }

    LogMsg::Handler LogMsg::handler() { return handler_; }

    void LogMsg::defaultHandler(int level, const char* s)
    {
        switch (static_cast<LogMsg::Level>(level)) {
        case LogMsg::debug: std::cerr << "Debug: "; break;
        case LogMsg::info:  std::cerr << "Info: "; break;
        case LogMsg::warn:  std::cerr << "Warning: "; break;
        case LogMsg::error: std::cerr << "Error: "; break;
        case LogMsg::mute:  assert(false);
        }
        std::cerr << s;
    }

    template<>
    void EXIV2API BasicError<char>::setMsg()
    {
        std::string msg = _(errMsg(code_));
        std::string::size_type pos;
        pos = msg.find("%0");
        if (pos != std::string::npos) {
            msg.replace(pos, 2, toString(static_cast<int>(code_)));
        }
        if (count_ > 0) {
            pos = msg.find("%1");
            if (pos != std::string::npos) {
                msg.replace(pos, 2, arg1_);
            }
        }
        if (count_ > 1) {
            pos = msg.find("%2");
            if (pos != std::string::npos) {
                msg.replace(pos, 2, arg2_);
            }
        }
        if (count_ > 2) {
            pos = msg.find("%3");
            if (pos != std::string::npos) {
                msg.replace(pos, 2, arg3_);
            }
        }
        msg_ = msg;
    }
#ifdef __APPLE__
    template class EXIV2API BasicError<char>;
#endif

    const char* errMsg(ErrorCode code)
    {
        const ErrMsg* em = find(errList, code);
        return em ? em->message_ : "";
    }

}                                       // namespace Exiv2