blob: 0d80c0254760a518f40f03de8afecc5d52ac9c49 [file] [log] [blame]
// UnicodeMap.h
// Mapping from Unicode to an encoding.
// Copyright 2001-2003 Glyph & Cog, LLC
// Modified under the Poppler project -
// All changes made under the Poppler project to this file are licensed
// under GPL version 2 or later
// Copyright (C) 2017 Adrian Johnson <>
// Copyright (C) 2018-2022 Albert Astals Cid <>
// Copyright (C) 2018 Adam Reichold <>
// Copyright (C) 2019 Volker Krause <>
// To see a description of the changes please see the Changelog file that
// came with your tarball or type make ChangeLog if you are building from git
#include "poppler-config.h"
#include "poppler_private_export.h"
#include "CharTypes.h"
#include <atomic>
#include <memory>
#include <string>
#include <vector>
enum UnicodeMapKind
unicodeMapUser, // read from a file
unicodeMapResident, // static list of ranges
unicodeMapFunc // function pointer
typedef int (*UnicodeMapFunc)(Unicode u, char *buf, int bufSize);
struct UnicodeMapRange
Unicode start, end; // range of Unicode chars
unsigned int code, nBytes; // first output code
struct UnicodeMapExt;
// Create the UnicodeMap specified by <encodingName>. Sets the
// initial reference count to 1. Returns NULL on failure.
static std::unique_ptr<UnicodeMap> parse(const std::string &encodingNameA);
// Create a resident UnicodeMap.
UnicodeMap(const char *encodingNameA, bool unicodeOutA, const UnicodeMapRange *rangesA, int lenA);
// Create a resident UnicodeMap that uses a function instead of a
// list of ranges.
UnicodeMap(const char *encodingNameA, bool unicodeOutA, UnicodeMapFunc funcA);
UnicodeMap(UnicodeMap &&other) noexcept;
UnicodeMap &operator=(UnicodeMap &&other) noexcept;
void swap(UnicodeMap &other) noexcept;
UnicodeMap(const UnicodeMap &) = delete;
UnicodeMap &operator=(const UnicodeMap &) = delete;
std::string getEncodingName() const { return encodingName; }
bool isUnicode() const { return unicodeOut; }
// Return true if this UnicodeMap matches the specified
// <encodingNameA>.
bool match(const std::string &encodingNameA) const;
// Map Unicode to the target encoding. Fills in <buf> with the
// output and returns the number of bytes used. Output will be
// truncated at <bufSize> bytes. No string terminator is written.
// Returns 0 if no mapping is found.
int mapUnicode(Unicode u, char *buf, int bufSize) const;
explicit UnicodeMap(const std::string &encodingNameA);
std::string encodingName;
UnicodeMapKind kind;
bool unicodeOut;
union {
const UnicodeMapRange *ranges; // (user, resident)
UnicodeMapFunc func; // (func)
int len; // (user, resident)
UnicodeMapExt *eMaps; // (user)
int eMapsLen; // (user)
class UnicodeMapCache
// Get the UnicodeMap for <encodingName>. Returns NULL on failure.
const UnicodeMap *getUnicodeMap(const std::string &encodingName);
std::vector<std::unique_ptr<UnicodeMap>> cache;