dicom_dictionary.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.
 
#pragma once
 
#include "dicom_tag.h"
#include "tag_info.h"
 
#include <mutex>
#include <optional>
#include <shared_mutex>
#include <span>
#include <string_view>
#include <unordered_map>
#include <vector>
 
namespace kcenon::pacs::core {
 
class dicom_dictionary {
public:
    [[nodiscard]] static auto instance() -> dicom_dictionary&;
 
    // Non-copyable and non-movable (singleton)
    dicom_dictionary(const dicom_dictionary&) = delete;
    dicom_dictionary(dicom_dictionary&&) = delete;
    auto operator=(const dicom_dictionary&) -> dicom_dictionary& = delete;
    auto operator=(dicom_dictionary&&) -> dicom_dictionary& = delete;
 
    [[nodiscard]] auto find(dicom_tag tag) const -> std::optional<tag_info>;
 
    [[nodiscard]] auto find_by_keyword(std::string_view keyword) const
        -> std::optional<tag_info>;
 
    [[nodiscard]] auto contains(dicom_tag tag) const -> bool;
 
    [[nodiscard]] auto contains_keyword(std::string_view keyword) const -> bool;
 
    [[nodiscard]] auto validate_vm(dicom_tag tag, uint32_t count) const -> bool;
 
    [[nodiscard]] auto get_vr(dicom_tag tag) const -> uint16_t;
 
    auto register_private_tag(const tag_info& info) -> bool;
 
    [[nodiscard]] auto size() const -> size_t;
 
    [[nodiscard]] auto standard_tag_count() const -> size_t;
 
    [[nodiscard]] auto private_tag_count() const -> size_t;
 
    [[nodiscard]] auto get_tags_in_group(uint16_t group) const
        -> std::vector<tag_info>;
 
private:
    dicom_dictionary();
 
    void initialize_standard_tags();
 
    std::unordered_map<dicom_tag, tag_info> tag_map_;
 
    std::unordered_map<std::string_view, dicom_tag> keyword_map_;
 
    size_t standard_count_{0};
 
    mutable std::shared_mutex mutex_;
};
 
}  // namespace kcenon::pacs::core