aboutsummaryrefslogtreecommitdiffstats
path: root/library/cpp/yt/string/format_string.h
blob: ebef9d704220d2aba6d36fab9e6453bf389d3ca9 (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
#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();

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>...>;

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

} // namespace NYT

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