tag_info.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 <cstdint>
#include <optional>
#include <string>
#include <string_view>
 
namespace kcenon::pacs::core {
 
struct value_multiplicity {
    uint32_t min{1};                     
    std::optional<uint32_t> max{1};      
    uint32_t multiplier{1};              
 
    constexpr value_multiplicity() noexcept = default;
 
    constexpr value_multiplicity(uint32_t min_val,
                                  std::optional<uint32_t> max_val,
                                  uint32_t mult = 1) noexcept
        : min{min_val}, max{max_val}, multiplier{mult} {}
 
    [[nodiscard]] constexpr auto is_valid(uint32_t count) const noexcept -> bool {
        if (count < min) {
            return false;
        }
        if (max.has_value()) {
            return count <= max.value();
        }
        // Unbounded case - check multiplier constraint
        if (multiplier > 1) {
            return (count - min) % multiplier == 0;
        }
        return true;
    }
 
    [[nodiscard]] constexpr auto allows_multiple() const noexcept -> bool {
        return !max.has_value() || max.value() > 1;
    }
 
    [[nodiscard]] constexpr auto is_unbounded() const noexcept -> bool {
        return !max.has_value();
    }
 
    [[nodiscard]] static auto from_string(std::string_view str)
        -> std::optional<value_multiplicity>;
 
    [[nodiscard]] auto to_string() const -> std::string;
};
 
struct tag_info {
    dicom_tag tag;                       
    uint16_t vr{0};                      
    value_multiplicity vm;               
    std::string_view keyword;            
    std::string_view name;               
    bool retired{false};                 
 
    [[nodiscard]] constexpr auto is_valid() const noexcept -> bool {
        return !keyword.empty();
    }
 
    [[nodiscard]] constexpr auto operator==(const tag_info& other) const noexcept -> bool {
        return tag == other.tag;
    }
 
    [[nodiscard]] constexpr auto operator<=>(const tag_info& other) const noexcept {
        return tag <=> other.tag;
    }
};
 
}  // namespace kcenon::pacs::core