bf29470384
-- bdce7e57e9e886eff1114d0266781b443f7ec639 by Derek Mauro <dmauro@google.com>: Change {Get|Set}EnvironmentVariable to {Get|Set}EnvironmentVariableA for compatibility with /DUNICODE. PiperOrigin-RevId: 239229514 -- 2276ed502326a044a84060d34eb19d499e3a3be2 by Derek Mauro <dmauro@google.com>: Import of CCTZ from GitHub. PiperOrigin-RevId: 239228622 -- a462efb970ff43b08a362ef2343fb75ac1295a50 by Derek Mauro <dmauro@google.com>: Adding linking of CoreFoundation to CMakeLists in absl/time. Import https://github.com/abseil/abseil-cpp/pull/280. Fix #283 PiperOrigin-RevId: 239220785 -- fc23327b97f940c682aae1956cf7a1bf87f88c06 by Derek Mauro <dmauro@google.com>: Add hermetic test script that uses Docker to build with a very recent version of gcc (8.3.0 today) with libstdc++ and bazel. PiperOrigin-RevId: 239220448 -- 418c08a8f6a53e63b84e39473035774417ca3aa7 by Derek Mauro <dmauro@google.com>: Disable part of the variant exeception safety test on move assignment when using versions of libstd++ that contain a bug. https://gcc.gnu.org/bugzilla/show_bug.cgi?id=87431#c7 PiperOrigin-RevId: 239062455 -- 799722217aeda79679577843c91d5be62cbcbb42 by Matt Calabrese <calabrese@google.com>: Add internal-only IsSwappable traits corresponding to std::is_swappable and std::is_nothrow_swappable, which are used with the swap implementations of optional and variant. PiperOrigin-RevId: 239049448 -- aa46a036038a3de5c68ac5e5d3b4bf76f818d2ea by CJ Johnson <johnsoncj@google.com>: Make InlinedVectorStorage constructor explicit PiperOrigin-RevId: 239044361 -- 17949715b3aa21c794701f69f2154e91b6acabc3 by CJ Johnson <johnsoncj@google.com>: Add absl namesapce to internal/inlined_vector.h PiperOrigin-RevId: 239030789 -- 834628325953078cc08ed10d23bb8890e5bec897 by Derek Mauro <dmauro@google.com>: Add test script that uses Docker to build Abseil with gcc-4.8, libstdc++, and cmake. PiperOrigin-RevId: 239028433 -- 80fe24149ed73ed2ced995ad1e372fb060c60427 by CJ Johnson <johnsoncj@google.com>: Factors data members of InlinedVector into an impl type called InlinedVectorStorage so that (in future changes) the contents of a vector can be grouped together with a single pointer. PiperOrigin-RevId: 239021086 -- 585331436d5d4d79f845e45dcf79d918a0dc6169 by Derek Mauro <dmauro@google.com>: Add -Wno-missing-field-initializers to gcc compiler flags. gcc-4.x has spurious missing field initializer warnings. https://gcc.gnu.org/bugzilla/show_bug.cgi?id=36750 PiperOrigin-RevId: 239017217 -- 94602fe4e33ee3a552a7f2939c0f57a992f55075 by Abseil Team <absl-team@google.com>: Formatting fixes. PiperOrigin-RevId: 238983038 -- a1c1b63c08505574e0a8c491561840cecb2bb93e by Derek Mauro <dmauro@google.com>: Add hermetic test script that uses Docker to build with a very recent version of clang with libc++ and bazel. PiperOrigin-RevId: 238669118 -- e525f8d20bc2f79a0d69336b902f63858f3bff9d by Derek Mauro <dmauro@google.com>: Disable the test optionalTest.InPlaceTSFINAEBug until libc++ is updated. PiperOrigin-RevId: 238661703 -- f99a2a0b5ec424a059678f7f226600f137b4c74e by Derek Mauro <dmauro@google.com>: Correct the check for the FlatHashMap-Any test bug (list conditions instead of platforms when possible) PiperOrigin-RevId: 238653344 -- 777928035dbcbf39f361eb7d10dc3696822f692f by Jon Cohen <cohenjon@google.com>: Add install rules for Abseil CMake. These are attempted to be limited to in-project installation. This serves two purposes -- first it's morally the same as using Abseil in-source, except you don't have to rebuild us every time. Second, the presence of an install rule makes life massively simpler for package manager maintainers. Currently this doesn't install absl tests or testonly libraries. This can be added in a follow-up patch. Fixes #38, Fixes #80, Closes #182 PiperOrigin-RevId: 238645836 -- ded1c6ce697c191b7a6ff14572b3e6d183117b2c by Derek Mauro <dmauro@google.com>: Add hermetic test script that uses Docker to build with a very recent version of clang with libstdc++ and bazel. PiperOrigin-RevId: 238517815 GitOrigin-RevId: bdce7e57e9e886eff1114d0266781b443f7ec639 Change-Id: I6f745869cb8ef63851891ccac05ae9a7dd241c4f
670 lines
32 KiB
C++
670 lines
32 KiB
C++
//
|
|
// Copyright 2017 The Abseil Authors.
|
|
//
|
|
// 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
|
|
//
|
|
// https://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.
|
|
//
|
|
// -----------------------------------------------------------------------------
|
|
// File: substitute.h
|
|
// -----------------------------------------------------------------------------
|
|
//
|
|
// This package contains functions for efficiently performing string
|
|
// substitutions using a format string with positional notation:
|
|
// `Substitute()` and `SubstituteAndAppend()`.
|
|
//
|
|
// Unlike printf-style format specifiers, `Substitute()` functions do not need
|
|
// to specify the type of the substitution arguments. Supported arguments
|
|
// following the format string, such as strings, string_views, ints,
|
|
// floats, and bools, are automatically converted to strings during the
|
|
// substitution process. (See below for a full list of supported types.)
|
|
//
|
|
// `Substitute()` does not allow you to specify *how* to format a value, beyond
|
|
// the default conversion to string. For example, you cannot format an integer
|
|
// in hex.
|
|
//
|
|
// The format string uses positional identifiers indicated by a dollar sign ($)
|
|
// and single digit positional ids to indicate which substitution arguments to
|
|
// use at that location within the format string.
|
|
//
|
|
// Example 1:
|
|
// std::string s = Substitute("$1 purchased $0 $2. Thanks $1!",
|
|
// 5, "Bob", "Apples");
|
|
// EXPECT_EQ("Bob purchased 5 Apples. Thanks Bob!", s);
|
|
//
|
|
// Example 2:
|
|
// std::string s = "Hi. ";
|
|
// SubstituteAndAppend(&s, "My name is $0 and I am $1 years old.", "Bob", 5);
|
|
// EXPECT_EQ("Hi. My name is Bob and I am 5 years old.", s);
|
|
//
|
|
// Supported types:
|
|
// * absl::string_view, std::string, const char* (null is equivalent to "")
|
|
// * int32_t, int64_t, uint32_t, uint64
|
|
// * float, double
|
|
// * bool (Printed as "true" or "false")
|
|
// * pointer types other than char* (Printed as "0x<lower case hex string>",
|
|
// except that null is printed as "NULL")
|
|
//
|
|
// If an invalid format string is provided, Substitute returns an empty string
|
|
// and SubstituteAndAppend does not change the provided output string.
|
|
// A format string is invalid if it:
|
|
// * ends in an unescaped $ character,
|
|
// e.g. "Hello $", or
|
|
// * calls for a position argument which is not provided,
|
|
// e.g. Substitute("Hello $2", "world"), or
|
|
// * specifies a non-digit, non-$ character after an unescaped $ character,
|
|
// e.g. "Hello $f".
|
|
// In debug mode, i.e. #ifndef NDEBUG, such errors terminate the program.
|
|
|
|
#ifndef ABSL_STRINGS_SUBSTITUTE_H_
|
|
#define ABSL_STRINGS_SUBSTITUTE_H_
|
|
|
|
#include <cstring>
|
|
#include <string>
|
|
|
|
#include "absl/base/macros.h"
|
|
#include "absl/base/port.h"
|
|
#include "absl/strings/ascii.h"
|
|
#include "absl/strings/escaping.h"
|
|
#include "absl/strings/numbers.h"
|
|
#include "absl/strings/str_cat.h"
|
|
#include "absl/strings/str_split.h"
|
|
#include "absl/strings/string_view.h"
|
|
#include "absl/strings/strip.h"
|
|
|
|
namespace absl {
|
|
namespace substitute_internal {
|
|
|
|
// Arg
|
|
//
|
|
// This class provides an argument type for `absl::Substitute()` and
|
|
// `absl::SubstituteAndAppend()`. `Arg` handles implicit conversion of various
|
|
// types to a string. (`Arg` is very similar to the `AlphaNum` class in
|
|
// `StrCat()`.)
|
|
//
|
|
// This class has implicit constructors.
|
|
class Arg {
|
|
public:
|
|
// Overloads for std::string-y things
|
|
//
|
|
// Explicitly overload `const char*` so the compiler doesn't cast to `bool`.
|
|
Arg(const char* value) // NOLINT(runtime/explicit)
|
|
: piece_(absl::NullSafeStringView(value)) {}
|
|
template <typename Allocator>
|
|
Arg( // NOLINT
|
|
const std::basic_string<char, std::char_traits<char>, Allocator>&
|
|
value) noexcept
|
|
: piece_(value) {}
|
|
Arg(absl::string_view value) // NOLINT(runtime/explicit)
|
|
: piece_(value) {}
|
|
|
|
// Overloads for primitives
|
|
//
|
|
// No overloads are available for signed and unsigned char because if people
|
|
// are explicitly declaring their chars as signed or unsigned then they are
|
|
// probably using them as 8-bit integers and would probably prefer an integer
|
|
// representation. However, we can't really know, so we make the caller decide
|
|
// what to do.
|
|
Arg(char value) // NOLINT(runtime/explicit)
|
|
: piece_(scratch_, 1) { scratch_[0] = value; }
|
|
Arg(short value) // NOLINT(*)
|
|
: piece_(scratch_,
|
|
numbers_internal::FastIntToBuffer(value, scratch_) - scratch_) {}
|
|
Arg(unsigned short value) // NOLINT(*)
|
|
: piece_(scratch_,
|
|
numbers_internal::FastIntToBuffer(value, scratch_) - scratch_) {}
|
|
Arg(int value) // NOLINT(runtime/explicit)
|
|
: piece_(scratch_,
|
|
numbers_internal::FastIntToBuffer(value, scratch_) - scratch_) {}
|
|
Arg(unsigned int value) // NOLINT(runtime/explicit)
|
|
: piece_(scratch_,
|
|
numbers_internal::FastIntToBuffer(value, scratch_) - scratch_) {}
|
|
Arg(long value) // NOLINT(*)
|
|
: piece_(scratch_,
|
|
numbers_internal::FastIntToBuffer(value, scratch_) - scratch_) {}
|
|
Arg(unsigned long value) // NOLINT(*)
|
|
: piece_(scratch_,
|
|
numbers_internal::FastIntToBuffer(value, scratch_) - scratch_) {}
|
|
Arg(long long value) // NOLINT(*)
|
|
: piece_(scratch_,
|
|
numbers_internal::FastIntToBuffer(value, scratch_) - scratch_) {}
|
|
Arg(unsigned long long value) // NOLINT(*)
|
|
: piece_(scratch_,
|
|
numbers_internal::FastIntToBuffer(value, scratch_) - scratch_) {}
|
|
Arg(float value) // NOLINT(runtime/explicit)
|
|
: piece_(scratch_, numbers_internal::SixDigitsToBuffer(value, scratch_)) {
|
|
}
|
|
Arg(double value) // NOLINT(runtime/explicit)
|
|
: piece_(scratch_, numbers_internal::SixDigitsToBuffer(value, scratch_)) {
|
|
}
|
|
Arg(bool value) // NOLINT(runtime/explicit)
|
|
: piece_(value ? "true" : "false") {}
|
|
|
|
Arg(Hex hex); // NOLINT(runtime/explicit)
|
|
Arg(Dec dec); // NOLINT(runtime/explicit)
|
|
|
|
// `void*` values, with the exception of `char*`, are printed as
|
|
// "0x<hex value>". However, in the case of `nullptr`, "NULL" is printed.
|
|
Arg(const void* value); // NOLINT(runtime/explicit)
|
|
|
|
Arg(const Arg&) = delete;
|
|
Arg& operator=(const Arg&) = delete;
|
|
|
|
absl::string_view piece() const { return piece_; }
|
|
|
|
private:
|
|
absl::string_view piece_;
|
|
char scratch_[numbers_internal::kFastToBufferSize];
|
|
};
|
|
|
|
// Internal helper function. Don't call this from outside this implementation.
|
|
// This interface may change without notice.
|
|
void SubstituteAndAppendArray(std::string* output, absl::string_view format,
|
|
const absl::string_view* args_array,
|
|
size_t num_args);
|
|
|
|
#if defined(ABSL_BAD_CALL_IF)
|
|
constexpr int CalculateOneBit(const char* format) {
|
|
return (*format < '0' || *format > '9') ? 0 : (1 << (*format - '0'));
|
|
}
|
|
|
|
constexpr const char* SkipNumber(const char* format) {
|
|
return !*format ? format : (format + 1);
|
|
}
|
|
|
|
constexpr int PlaceholderBitmask(const char* format) {
|
|
return !*format ? 0 : *format != '$'
|
|
? PlaceholderBitmask(format + 1)
|
|
: (CalculateOneBit(format + 1) |
|
|
PlaceholderBitmask(SkipNumber(format + 1)));
|
|
}
|
|
#endif // ABSL_BAD_CALL_IF
|
|
|
|
} // namespace substitute_internal
|
|
|
|
//
|
|
// PUBLIC API
|
|
//
|
|
|
|
// SubstituteAndAppend()
|
|
//
|
|
// Substitutes variables into a given format string and appends to a given
|
|
// output string. See file comments above for usage.
|
|
//
|
|
// The declarations of `SubstituteAndAppend()` below consist of overloads
|
|
// for passing 0 to 10 arguments, respectively.
|
|
//
|
|
// NOTE: A zero-argument `SubstituteAndAppend()` may be used within variadic
|
|
// templates to allow a variable number of arguments.
|
|
//
|
|
// Example:
|
|
// template <typename... Args>
|
|
// void VarMsg(std::string* boilerplate, absl::string_view format,
|
|
// const Args&... args) {
|
|
// absl::SubstituteAndAppend(boilerplate, format, args...);
|
|
// }
|
|
//
|
|
inline void SubstituteAndAppend(std::string* output, absl::string_view format) {
|
|
substitute_internal::SubstituteAndAppendArray(output, format, nullptr, 0);
|
|
}
|
|
|
|
inline void SubstituteAndAppend(std::string* output, absl::string_view format,
|
|
const substitute_internal::Arg& a0) {
|
|
const absl::string_view args[] = {a0.piece()};
|
|
substitute_internal::SubstituteAndAppendArray(output, format, args,
|
|
ABSL_ARRAYSIZE(args));
|
|
}
|
|
|
|
inline void SubstituteAndAppend(std::string* output, absl::string_view format,
|
|
const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1) {
|
|
const absl::string_view args[] = {a0.piece(), a1.piece()};
|
|
substitute_internal::SubstituteAndAppendArray(output, format, args,
|
|
ABSL_ARRAYSIZE(args));
|
|
}
|
|
|
|
inline void SubstituteAndAppend(std::string* output, absl::string_view format,
|
|
const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1,
|
|
const substitute_internal::Arg& a2) {
|
|
const absl::string_view args[] = {a0.piece(), a1.piece(), a2.piece()};
|
|
substitute_internal::SubstituteAndAppendArray(output, format, args,
|
|
ABSL_ARRAYSIZE(args));
|
|
}
|
|
|
|
inline void SubstituteAndAppend(std::string* output, absl::string_view format,
|
|
const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1,
|
|
const substitute_internal::Arg& a2,
|
|
const substitute_internal::Arg& a3) {
|
|
const absl::string_view args[] = {a0.piece(), a1.piece(), a2.piece(),
|
|
a3.piece()};
|
|
substitute_internal::SubstituteAndAppendArray(output, format, args,
|
|
ABSL_ARRAYSIZE(args));
|
|
}
|
|
|
|
inline void SubstituteAndAppend(std::string* output, absl::string_view format,
|
|
const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1,
|
|
const substitute_internal::Arg& a2,
|
|
const substitute_internal::Arg& a3,
|
|
const substitute_internal::Arg& a4) {
|
|
const absl::string_view args[] = {a0.piece(), a1.piece(), a2.piece(),
|
|
a3.piece(), a4.piece()};
|
|
substitute_internal::SubstituteAndAppendArray(output, format, args,
|
|
ABSL_ARRAYSIZE(args));
|
|
}
|
|
|
|
inline void SubstituteAndAppend(std::string* output, absl::string_view format,
|
|
const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1,
|
|
const substitute_internal::Arg& a2,
|
|
const substitute_internal::Arg& a3,
|
|
const substitute_internal::Arg& a4,
|
|
const substitute_internal::Arg& a5) {
|
|
const absl::string_view args[] = {a0.piece(), a1.piece(), a2.piece(),
|
|
a3.piece(), a4.piece(), a5.piece()};
|
|
substitute_internal::SubstituteAndAppendArray(output, format, args,
|
|
ABSL_ARRAYSIZE(args));
|
|
}
|
|
|
|
inline void SubstituteAndAppend(std::string* output, absl::string_view format,
|
|
const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1,
|
|
const substitute_internal::Arg& a2,
|
|
const substitute_internal::Arg& a3,
|
|
const substitute_internal::Arg& a4,
|
|
const substitute_internal::Arg& a5,
|
|
const substitute_internal::Arg& a6) {
|
|
const absl::string_view args[] = {a0.piece(), a1.piece(), a2.piece(),
|
|
a3.piece(), a4.piece(), a5.piece(),
|
|
a6.piece()};
|
|
substitute_internal::SubstituteAndAppendArray(output, format, args,
|
|
ABSL_ARRAYSIZE(args));
|
|
}
|
|
|
|
inline void SubstituteAndAppend(
|
|
std::string* output, absl::string_view format,
|
|
const substitute_internal::Arg& a0, const substitute_internal::Arg& a1,
|
|
const substitute_internal::Arg& a2, const substitute_internal::Arg& a3,
|
|
const substitute_internal::Arg& a4, const substitute_internal::Arg& a5,
|
|
const substitute_internal::Arg& a6, const substitute_internal::Arg& a7) {
|
|
const absl::string_view args[] = {a0.piece(), a1.piece(), a2.piece(),
|
|
a3.piece(), a4.piece(), a5.piece(),
|
|
a6.piece(), a7.piece()};
|
|
substitute_internal::SubstituteAndAppendArray(output, format, args,
|
|
ABSL_ARRAYSIZE(args));
|
|
}
|
|
|
|
inline void SubstituteAndAppend(
|
|
std::string* output, absl::string_view format,
|
|
const substitute_internal::Arg& a0, const substitute_internal::Arg& a1,
|
|
const substitute_internal::Arg& a2, const substitute_internal::Arg& a3,
|
|
const substitute_internal::Arg& a4, const substitute_internal::Arg& a5,
|
|
const substitute_internal::Arg& a6, const substitute_internal::Arg& a7,
|
|
const substitute_internal::Arg& a8) {
|
|
const absl::string_view args[] = {a0.piece(), a1.piece(), a2.piece(),
|
|
a3.piece(), a4.piece(), a5.piece(),
|
|
a6.piece(), a7.piece(), a8.piece()};
|
|
substitute_internal::SubstituteAndAppendArray(output, format, args,
|
|
ABSL_ARRAYSIZE(args));
|
|
}
|
|
|
|
inline void SubstituteAndAppend(
|
|
std::string* output, absl::string_view format,
|
|
const substitute_internal::Arg& a0, const substitute_internal::Arg& a1,
|
|
const substitute_internal::Arg& a2, const substitute_internal::Arg& a3,
|
|
const substitute_internal::Arg& a4, const substitute_internal::Arg& a5,
|
|
const substitute_internal::Arg& a6, const substitute_internal::Arg& a7,
|
|
const substitute_internal::Arg& a8, const substitute_internal::Arg& a9) {
|
|
const absl::string_view args[] = {
|
|
a0.piece(), a1.piece(), a2.piece(), a3.piece(), a4.piece(),
|
|
a5.piece(), a6.piece(), a7.piece(), a8.piece(), a9.piece()};
|
|
substitute_internal::SubstituteAndAppendArray(output, format, args,
|
|
ABSL_ARRAYSIZE(args));
|
|
}
|
|
|
|
#if defined(ABSL_BAD_CALL_IF)
|
|
// This body of functions catches cases where the number of placeholders
|
|
// doesn't match the number of data arguments.
|
|
void SubstituteAndAppend(std::string* output, const char* format)
|
|
ABSL_BAD_CALL_IF(substitute_internal::PlaceholderBitmask(format) != 0,
|
|
"There were no substitution arguments "
|
|
"but this format std::string has a $[0-9] in it");
|
|
|
|
void SubstituteAndAppend(std::string* output, const char* format,
|
|
const substitute_internal::Arg& a0)
|
|
ABSL_BAD_CALL_IF(substitute_internal::PlaceholderBitmask(format) != 1,
|
|
"There was 1 substitution argument given, but "
|
|
"this format std::string is either missing its $0, or "
|
|
"contains one of $1-$9");
|
|
|
|
void SubstituteAndAppend(std::string* output, const char* format,
|
|
const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1)
|
|
ABSL_BAD_CALL_IF(substitute_internal::PlaceholderBitmask(format) != 3,
|
|
"There were 2 substitution arguments given, but "
|
|
"this format std::string is either missing its $0/$1, or "
|
|
"contains one of $2-$9");
|
|
|
|
void SubstituteAndAppend(std::string* output, const char* format,
|
|
const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1,
|
|
const substitute_internal::Arg& a2)
|
|
ABSL_BAD_CALL_IF(substitute_internal::PlaceholderBitmask(format) != 7,
|
|
"There were 3 substitution arguments given, but "
|
|
"this format std::string is either missing its $0/$1/$2, or "
|
|
"contains one of $3-$9");
|
|
|
|
void SubstituteAndAppend(std::string* output, const char* format,
|
|
const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1,
|
|
const substitute_internal::Arg& a2,
|
|
const substitute_internal::Arg& a3)
|
|
ABSL_BAD_CALL_IF(substitute_internal::PlaceholderBitmask(format) != 15,
|
|
"There were 4 substitution arguments given, but "
|
|
"this format std::string is either missing its $0-$3, or "
|
|
"contains one of $4-$9");
|
|
|
|
void SubstituteAndAppend(std::string* output, const char* format,
|
|
const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1,
|
|
const substitute_internal::Arg& a2,
|
|
const substitute_internal::Arg& a3,
|
|
const substitute_internal::Arg& a4)
|
|
ABSL_BAD_CALL_IF(substitute_internal::PlaceholderBitmask(format) != 31,
|
|
"There were 5 substitution arguments given, but "
|
|
"this format std::string is either missing its $0-$4, or "
|
|
"contains one of $5-$9");
|
|
|
|
void SubstituteAndAppend(std::string* output, const char* format,
|
|
const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1,
|
|
const substitute_internal::Arg& a2,
|
|
const substitute_internal::Arg& a3,
|
|
const substitute_internal::Arg& a4,
|
|
const substitute_internal::Arg& a5)
|
|
ABSL_BAD_CALL_IF(substitute_internal::PlaceholderBitmask(format) != 63,
|
|
"There were 6 substitution arguments given, but "
|
|
"this format std::string is either missing its $0-$5, or "
|
|
"contains one of $6-$9");
|
|
|
|
void SubstituteAndAppend(
|
|
std::string* output, const char* format, const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1, const substitute_internal::Arg& a2,
|
|
const substitute_internal::Arg& a3, const substitute_internal::Arg& a4,
|
|
const substitute_internal::Arg& a5, const substitute_internal::Arg& a6)
|
|
ABSL_BAD_CALL_IF(substitute_internal::PlaceholderBitmask(format) != 127,
|
|
"There were 7 substitution arguments given, but "
|
|
"this format std::string is either missing its $0-$6, or "
|
|
"contains one of $7-$9");
|
|
|
|
void SubstituteAndAppend(
|
|
std::string* output, const char* format, const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1, const substitute_internal::Arg& a2,
|
|
const substitute_internal::Arg& a3, const substitute_internal::Arg& a4,
|
|
const substitute_internal::Arg& a5, const substitute_internal::Arg& a6,
|
|
const substitute_internal::Arg& a7)
|
|
ABSL_BAD_CALL_IF(substitute_internal::PlaceholderBitmask(format) != 255,
|
|
"There were 8 substitution arguments given, but "
|
|
"this format std::string is either missing its $0-$7, or "
|
|
"contains one of $8-$9");
|
|
|
|
void SubstituteAndAppend(
|
|
std::string* output, const char* format, const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1, const substitute_internal::Arg& a2,
|
|
const substitute_internal::Arg& a3, const substitute_internal::Arg& a4,
|
|
const substitute_internal::Arg& a5, const substitute_internal::Arg& a6,
|
|
const substitute_internal::Arg& a7, const substitute_internal::Arg& a8)
|
|
ABSL_BAD_CALL_IF(
|
|
substitute_internal::PlaceholderBitmask(format) != 511,
|
|
"There were 9 substitution arguments given, but "
|
|
"this format std::string is either missing its $0-$8, or contains a $9");
|
|
|
|
void SubstituteAndAppend(
|
|
std::string* output, const char* format, const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1, const substitute_internal::Arg& a2,
|
|
const substitute_internal::Arg& a3, const substitute_internal::Arg& a4,
|
|
const substitute_internal::Arg& a5, const substitute_internal::Arg& a6,
|
|
const substitute_internal::Arg& a7, const substitute_internal::Arg& a8,
|
|
const substitute_internal::Arg& a9)
|
|
ABSL_BAD_CALL_IF(substitute_internal::PlaceholderBitmask(format) != 1023,
|
|
"There were 10 substitution arguments given, but this "
|
|
"format std::string doesn't contain all of $0 through $9");
|
|
#endif // ABSL_BAD_CALL_IF
|
|
|
|
// Substitute()
|
|
//
|
|
// Substitutes variables into a given format string. See file comments above
|
|
// for usage.
|
|
//
|
|
// The declarations of `Substitute()` below consist of overloads for passing 0
|
|
// to 10 arguments, respectively.
|
|
//
|
|
// NOTE: A zero-argument `Substitute()` may be used within variadic templates to
|
|
// allow a variable number of arguments.
|
|
//
|
|
// Example:
|
|
// template <typename... Args>
|
|
// void VarMsg(absl::string_view format, const Args&... args) {
|
|
// std::string s = absl::Substitute(format, args...);
|
|
|
|
ABSL_MUST_USE_RESULT inline std::string Substitute(absl::string_view format) {
|
|
std::string result;
|
|
SubstituteAndAppend(&result, format);
|
|
return result;
|
|
}
|
|
|
|
ABSL_MUST_USE_RESULT inline std::string Substitute(
|
|
absl::string_view format, const substitute_internal::Arg& a0) {
|
|
std::string result;
|
|
SubstituteAndAppend(&result, format, a0);
|
|
return result;
|
|
}
|
|
|
|
ABSL_MUST_USE_RESULT inline std::string Substitute(
|
|
absl::string_view format, const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1) {
|
|
std::string result;
|
|
SubstituteAndAppend(&result, format, a0, a1);
|
|
return result;
|
|
}
|
|
|
|
ABSL_MUST_USE_RESULT inline std::string Substitute(
|
|
absl::string_view format, const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1, const substitute_internal::Arg& a2) {
|
|
std::string result;
|
|
SubstituteAndAppend(&result, format, a0, a1, a2);
|
|
return result;
|
|
}
|
|
|
|
ABSL_MUST_USE_RESULT inline std::string Substitute(
|
|
absl::string_view format, const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1, const substitute_internal::Arg& a2,
|
|
const substitute_internal::Arg& a3) {
|
|
std::string result;
|
|
SubstituteAndAppend(&result, format, a0, a1, a2, a3);
|
|
return result;
|
|
}
|
|
|
|
ABSL_MUST_USE_RESULT inline std::string Substitute(
|
|
absl::string_view format, const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1, const substitute_internal::Arg& a2,
|
|
const substitute_internal::Arg& a3, const substitute_internal::Arg& a4) {
|
|
std::string result;
|
|
SubstituteAndAppend(&result, format, a0, a1, a2, a3, a4);
|
|
return result;
|
|
}
|
|
|
|
ABSL_MUST_USE_RESULT inline std::string Substitute(
|
|
absl::string_view format, const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1, const substitute_internal::Arg& a2,
|
|
const substitute_internal::Arg& a3, const substitute_internal::Arg& a4,
|
|
const substitute_internal::Arg& a5) {
|
|
std::string result;
|
|
SubstituteAndAppend(&result, format, a0, a1, a2, a3, a4, a5);
|
|
return result;
|
|
}
|
|
|
|
ABSL_MUST_USE_RESULT inline std::string Substitute(
|
|
absl::string_view format, const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1, const substitute_internal::Arg& a2,
|
|
const substitute_internal::Arg& a3, const substitute_internal::Arg& a4,
|
|
const substitute_internal::Arg& a5, const substitute_internal::Arg& a6) {
|
|
std::string result;
|
|
SubstituteAndAppend(&result, format, a0, a1, a2, a3, a4, a5, a6);
|
|
return result;
|
|
}
|
|
|
|
ABSL_MUST_USE_RESULT inline std::string Substitute(
|
|
absl::string_view format, const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1, const substitute_internal::Arg& a2,
|
|
const substitute_internal::Arg& a3, const substitute_internal::Arg& a4,
|
|
const substitute_internal::Arg& a5, const substitute_internal::Arg& a6,
|
|
const substitute_internal::Arg& a7) {
|
|
std::string result;
|
|
SubstituteAndAppend(&result, format, a0, a1, a2, a3, a4, a5, a6, a7);
|
|
return result;
|
|
}
|
|
|
|
ABSL_MUST_USE_RESULT inline std::string Substitute(
|
|
absl::string_view format, const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1, const substitute_internal::Arg& a2,
|
|
const substitute_internal::Arg& a3, const substitute_internal::Arg& a4,
|
|
const substitute_internal::Arg& a5, const substitute_internal::Arg& a6,
|
|
const substitute_internal::Arg& a7, const substitute_internal::Arg& a8) {
|
|
std::string result;
|
|
SubstituteAndAppend(&result, format, a0, a1, a2, a3, a4, a5, a6, a7, a8);
|
|
return result;
|
|
}
|
|
|
|
ABSL_MUST_USE_RESULT inline std::string Substitute(
|
|
absl::string_view format, const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1, const substitute_internal::Arg& a2,
|
|
const substitute_internal::Arg& a3, const substitute_internal::Arg& a4,
|
|
const substitute_internal::Arg& a5, const substitute_internal::Arg& a6,
|
|
const substitute_internal::Arg& a7, const substitute_internal::Arg& a8,
|
|
const substitute_internal::Arg& a9) {
|
|
std::string result;
|
|
SubstituteAndAppend(&result, format, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9);
|
|
return result;
|
|
}
|
|
|
|
#if defined(ABSL_BAD_CALL_IF)
|
|
// This body of functions catches cases where the number of placeholders
|
|
// doesn't match the number of data arguments.
|
|
std::string Substitute(const char* format)
|
|
ABSL_BAD_CALL_IF(substitute_internal::PlaceholderBitmask(format) != 0,
|
|
"There were no substitution arguments "
|
|
"but this format std::string has a $[0-9] in it");
|
|
|
|
std::string Substitute(const char* format, const substitute_internal::Arg& a0)
|
|
ABSL_BAD_CALL_IF(substitute_internal::PlaceholderBitmask(format) != 1,
|
|
"There was 1 substitution argument given, but "
|
|
"this format std::string is either missing its $0, or "
|
|
"contains one of $1-$9");
|
|
|
|
std::string Substitute(const char* format, const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1)
|
|
ABSL_BAD_CALL_IF(substitute_internal::PlaceholderBitmask(format) != 3,
|
|
"There were 2 substitution arguments given, but "
|
|
"this format std::string is either missing its $0/$1, or "
|
|
"contains one of $2-$9");
|
|
|
|
std::string Substitute(const char* format, const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1,
|
|
const substitute_internal::Arg& a2)
|
|
ABSL_BAD_CALL_IF(substitute_internal::PlaceholderBitmask(format) != 7,
|
|
"There were 3 substitution arguments given, but "
|
|
"this format std::string is either missing its $0/$1/$2, or "
|
|
"contains one of $3-$9");
|
|
|
|
std::string Substitute(const char* format, const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1,
|
|
const substitute_internal::Arg& a2,
|
|
const substitute_internal::Arg& a3)
|
|
ABSL_BAD_CALL_IF(substitute_internal::PlaceholderBitmask(format) != 15,
|
|
"There were 4 substitution arguments given, but "
|
|
"this format std::string is either missing its $0-$3, or "
|
|
"contains one of $4-$9");
|
|
|
|
std::string Substitute(const char* format, const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1,
|
|
const substitute_internal::Arg& a2,
|
|
const substitute_internal::Arg& a3,
|
|
const substitute_internal::Arg& a4)
|
|
ABSL_BAD_CALL_IF(substitute_internal::PlaceholderBitmask(format) != 31,
|
|
"There were 5 substitution arguments given, but "
|
|
"this format std::string is either missing its $0-$4, or "
|
|
"contains one of $5-$9");
|
|
|
|
std::string Substitute(const char* format, const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1,
|
|
const substitute_internal::Arg& a2,
|
|
const substitute_internal::Arg& a3,
|
|
const substitute_internal::Arg& a4,
|
|
const substitute_internal::Arg& a5)
|
|
ABSL_BAD_CALL_IF(substitute_internal::PlaceholderBitmask(format) != 63,
|
|
"There were 6 substitution arguments given, but "
|
|
"this format std::string is either missing its $0-$5, or "
|
|
"contains one of $6-$9");
|
|
|
|
std::string Substitute(const char* format, const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1,
|
|
const substitute_internal::Arg& a2,
|
|
const substitute_internal::Arg& a3,
|
|
const substitute_internal::Arg& a4,
|
|
const substitute_internal::Arg& a5,
|
|
const substitute_internal::Arg& a6)
|
|
ABSL_BAD_CALL_IF(substitute_internal::PlaceholderBitmask(format) != 127,
|
|
"There were 7 substitution arguments given, but "
|
|
"this format std::string is either missing its $0-$6, or "
|
|
"contains one of $7-$9");
|
|
|
|
std::string Substitute(const char* format, const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1,
|
|
const substitute_internal::Arg& a2,
|
|
const substitute_internal::Arg& a3,
|
|
const substitute_internal::Arg& a4,
|
|
const substitute_internal::Arg& a5,
|
|
const substitute_internal::Arg& a6,
|
|
const substitute_internal::Arg& a7)
|
|
ABSL_BAD_CALL_IF(substitute_internal::PlaceholderBitmask(format) != 255,
|
|
"There were 8 substitution arguments given, but "
|
|
"this format std::string is either missing its $0-$7, or "
|
|
"contains one of $8-$9");
|
|
|
|
std::string Substitute(
|
|
const char* format, const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1, const substitute_internal::Arg& a2,
|
|
const substitute_internal::Arg& a3, const substitute_internal::Arg& a4,
|
|
const substitute_internal::Arg& a5, const substitute_internal::Arg& a6,
|
|
const substitute_internal::Arg& a7, const substitute_internal::Arg& a8)
|
|
ABSL_BAD_CALL_IF(
|
|
substitute_internal::PlaceholderBitmask(format) != 511,
|
|
"There were 9 substitution arguments given, but "
|
|
"this format std::string is either missing its $0-$8, or contains a $9");
|
|
|
|
std::string Substitute(
|
|
const char* format, const substitute_internal::Arg& a0,
|
|
const substitute_internal::Arg& a1, const substitute_internal::Arg& a2,
|
|
const substitute_internal::Arg& a3, const substitute_internal::Arg& a4,
|
|
const substitute_internal::Arg& a5, const substitute_internal::Arg& a6,
|
|
const substitute_internal::Arg& a7, const substitute_internal::Arg& a8,
|
|
const substitute_internal::Arg& a9)
|
|
ABSL_BAD_CALL_IF(substitute_internal::PlaceholderBitmask(format) != 1023,
|
|
"There were 10 substitution arguments given, but this "
|
|
"format std::string doesn't contain all of $0 through $9");
|
|
#endif // ABSL_BAD_CALL_IF
|
|
|
|
} // namespace absl
|
|
|
|
#endif // ABSL_STRINGS_SUBSTITUTE_H_
|