aboutsummaryrefslogtreecommitdiffstats
path: root/library/cpp/yt/string/format_string.h
blob: 1008ccb45334dde8513846f2d400e687e2999451 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
#pragma once

#include "format_analyser.h"

#include <util/generic/strbuf.h>

#if (!__clang__ || __clang_major__ < 16)
    #define YT_DISABLE_FORMAT_STATIC_ANALYSIS
#endif

namespace NYT {

////////////////////////////////////////////////////////////////////////////////

// Explicitly create TRuntimeFormat if you wish to
// use runtime/non-literal value as format.
class TRuntimeFormat
{
public:
    explicit TRuntimeFormat(TStringBuf fmt);

    TStringBuf Get() const noexcept;

private:
    TStringBuf Format_;
};

// This class used to properly bind to
// string literals and allow compile-time parsing/checking
// of those. If you need a runtime format, use TRuntimeFormat.
template <class... TArgs>
class TBasicFormatString
{
public:
    // Can be used to perform compile-time check of format.
    template <class T>
        requires std::constructible_from<std::string_view, T>
    consteval TBasicFormatString(const T& fmt);

    TBasicFormatString(TRuntimeFormat fmt);

    TStringBuf Get() const noexcept;

    static consteval void CheckFormattability();

    // Data used for compile-time slicing of the format string.
    NDetail::TFormatAnalyser::TMarkerLocations<TArgs...> Markers = {};
    NDetail::TFormatAnalyser::TEscapeLocations Escapes = {};

private:
    std::string_view Format_;

    template <class T>
    static void CrashCompilerClassIsNotFormattable();
};

// Used to properly infer template arguments in Format.
template <class... TArgs>
using TFormatString = TBasicFormatString<std::type_identity_t<TArgs>...>;

////////////////////////////////////////////////////////////////////////////////

template <class T>
concept CStringLiteral = requires (T& t) {
    [] (const char*) { } (t);
};

////////////////////////////////////////////////////////////////////////////////

} // namespace NYT

#define FORMAT_STRING_INL_H_
#include "format_string-inl.h"
#undef FORMAT_STRING_INL_H_