string_view.h File Reference

POD-safe string_view with full constexpr semantics and consteval/runtime dual-path optimization. More...

#include <algorithm>
#include <compare>
#include <cstdint>
#include <cstring>
#include <string_view>
#include <type_traits>
#include <cstddef>
#include "jh/metax/char.h"
#include "jh/pods/pod_like.h"
#include "jh/detail/base64_common.h"
#include "jh/metax/hash.h"

Go to the source code of this file.

Classes
struct	jh::pod::string_view
	Read-only string view with POD layout. More...

Namespaces
namespace	jh::pod
	Aggregated entry point for Plain-Old-Data and layout-stable value utilities.
namespace	jh::pod::literals
	Official literal helpers for jh::pod types.

Functions
constexpr jh::pod::string_view	jh::pod::literals::operator""_psv (const char *str, std::size_t len) noexcept
	User-defined literal for jh::pod::string_view.

Detailed Description

POD-safe string_view with full constexpr semantics and consteval/runtime dual-path optimization.

Copyright

Copyright 2025 JeongHan-Bae <mastropseudo@gmail.com>
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Full license: GitHub

This header defines a lightweight, read-only, non-owning string view specifically designed for POD-compatible use cases, offering constexpr evaluation and optimized runtime behavior.

Highlights:

• POD layout: strictly { const char*, uint64_t }
• All operations constexpr: usable in both compile-time (consteval) and runtime contexts
• Dual-path design:
  • Constexpr-safe logic for compile-time evaluation
  • Accelerated runtime path using memcmp / memcpy
• Deep comparison via memcmp, not pointer identity
• Constexpr hash supported — usable in consteval expressions
• Designed as a safe view type for immutable_str and POD containers

Usage Notes:

• Provides zero-overhead interop with std::string_view
• Supports compile-time construction via from_literal() or "..."_psv
• No dynamic allocation, no exceptions, fully constexpr evaluable
• Enables compile-time hashing (e.g., jh::meta::t_str)