character_set.h

Go to the documentation of this file.

// BSD 3-Clause License
// Copyright (c) 2021-2025, 🍀☀🌕🌥 🌊
// See the LICENSE file in the project root for full license information.
 
#ifndef PACS_ENCODING_CHARACTER_SET_HPP
#define PACS_ENCODING_CHARACTER_SET_HPP
 
#include <cstdint>
#include <optional>
#include <string>
#include <string_view>
#include <vector>
 
namespace kcenon::pacs::encoding {
 
struct character_set_info {
    std::string_view defined_term;     
    std::string_view description;      
    std::string_view iso_ir;           
    bool uses_code_extensions;         
    std::string_view escape_sequence;  
    std::string_view encoding_name;    
    bool is_multi_byte;               
};
 
 
[[nodiscard]] const character_set_info* find_character_set(
    std::string_view defined_term) noexcept;
 
[[nodiscard]] const character_set_info* find_character_set_by_ir(
    int iso_ir_number) noexcept;
 
[[nodiscard]] const character_set_info& default_character_set() noexcept;
 
[[nodiscard]] std::vector<const character_set_info*> all_character_sets() noexcept;
 
 
 
struct specific_character_set {
    const character_set_info* default_set;
 
    std::vector<const character_set_info*> extension_sets;
 
    [[nodiscard]] bool uses_extensions() const noexcept;
 
    [[nodiscard]] bool is_single_byte_only() const noexcept;
 
    [[nodiscard]] bool is_utf8() const noexcept;
};
 
[[nodiscard]] specific_character_set parse_specific_character_set(
    std::string_view value);
 
 
 
struct text_segment {
    std::string_view text;                 
    const character_set_info* charset;     
};
 
[[nodiscard]] std::vector<text_segment> split_by_escape_sequences(
    std::string_view text,
    const specific_character_set& scs);
 
 
 
[[nodiscard]] std::string decode_to_utf8(
    std::string_view text,
    const specific_character_set& scs);
 
[[nodiscard]] std::string convert_to_utf8(
    std::string_view text,
    const character_set_info& charset);
 
[[nodiscard]] std::string decode_person_name(
    std::string_view pn_value,
    const specific_character_set& scs);
 
[[nodiscard]] std::string encode_from_utf8(
    std::string_view utf8_text,
    const specific_character_set& scs);
 
[[nodiscard]] std::string convert_from_utf8(
    std::string_view utf8_text,
    const character_set_info& charset);
 
 
}  // namespace kcenon::pacs::encoding
 
#endif  // PACS_ENCODING_CHARACTER_SET_HPP