/src/abseil-cpp/absl/flags/marshalling.cc

Source
//
//  Copyright 2019 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.

#include "absl/flags/marshalling.h"

#include <stddef.h>

#include <cmath>
#include <limits>
#include <sstream>
#include <string>
#include <type_traits>
#include <vector>

#include "absl/base/config.h"
#include "absl/base/log_severity.h"
#include "absl/base/macros.h"
#include "absl/numeric/int128.h"
#include "absl/strings/ascii.h"
#include "absl/strings/match.h"
#include "absl/strings/numbers.h"
#include "absl/strings/str_cat.h"
#include "absl/strings/str_format.h"
#include "absl/strings/str_join.h"
#include "absl/strings/str_split.h"
#include "absl/strings/string_view.h"

namespace absl {
ABSL_NAMESPACE_BEGIN
namespace flags_internal {

// --------------------------------------------------------------------
// AbslParseFlag specializations for boolean type.

bool AbslParseFlag(absl::string_view text, bool* dst, std::string*) {
  return SimpleAtob(absl::StripAsciiWhitespace(text), dst);
}

// --------------------------------------------------------------------
// AbslParseFlag for integral types.

// Return the base to use for parsing text as an integer.  Leading 0x
// puts us in base 16.  But leading 0 does not put us in base 8. It
// caused too many bugs when we had that behavior.
static int NumericBase(absl::string_view text) {
  if (text.empty()) return 0;
  size_t num_start = (text[0] == '-' || text[0] == '+') ? 1 : 0;
  const bool hex = (text.size() >= num_start + 2 && text[num_start] == '0' &&
                    (text[num_start + 1] == 'x' || text[num_start + 1] == 'X'));
  return hex ? 16 : 10;
}

template <typename IntType>
inline bool ParseFlagImpl(absl::string_view text, IntType& dst) {
  text = absl::StripAsciiWhitespace(text);

  return absl::numbers_internal::safe_strtoi_base(text, &dst,
                                                  NumericBase(text));
}

bool AbslParseFlag(absl::string_view text, short* dst, std::string*) {
  int val;
  if (!ParseFlagImpl(text, val)) return false;
  if (static_cast<short>(val) != val)  // worked, but number out of range
    return false;
  *dst = static_cast<short>(val);
  return true;
}

bool AbslParseFlag(absl::string_view text, unsigned short* dst, std::string*) {
  unsigned int val;
  if (!ParseFlagImpl(text, val)) return false;
  if (static_cast<unsigned short>(val) !=
      val)  // worked, but number out of range
    return false;
  *dst = static_cast<unsigned short>(val);
  return true;
}

bool AbslParseFlag(absl::string_view text, int* dst, std::string*) {
  return ParseFlagImpl(text, *dst);
}

bool AbslParseFlag(absl::string_view text, unsigned int* dst, std::string*) {
  return ParseFlagImpl(text, *dst);
}

bool AbslParseFlag(absl::string_view text, long* dst, std::string*) {
  return ParseFlagImpl(text, *dst);
}

bool AbslParseFlag(absl::string_view text, unsigned long* dst, std::string*) {
  return ParseFlagImpl(text, *dst);
}

bool AbslParseFlag(absl::string_view text, long long* dst, std::string*) {
  return ParseFlagImpl(text, *dst);
}

bool AbslParseFlag(absl::string_view text, unsigned long long* dst,
                   std::string*) {
  return ParseFlagImpl(text, *dst);
}

bool AbslParseFlag(absl::string_view text, absl::int128* dst, std::string*) {
  text = absl::StripAsciiWhitespace(text);

  // check hex
  int base = NumericBase(text);
  if (!absl::numbers_internal::safe_strto128_base(text, dst, base)) {
    return false;
  }

  return base == 16 ? absl::SimpleHexAtoi(text, dst)
                    : absl::SimpleAtoi(text, dst);
}

bool AbslParseFlag(absl::string_view text, absl::uint128* dst, std::string*) {
  text = absl::StripAsciiWhitespace(text);

  // check hex
  int base = NumericBase(text);
  if (!absl::numbers_internal::safe_strtou128_base(text, dst, base)) {
    return false;
  }

  return base == 16 ? absl::SimpleHexAtoi(text, dst)
                    : absl::SimpleAtoi(text, dst);
}

// --------------------------------------------------------------------
// AbslParseFlag for floating point types.

bool AbslParseFlag(absl::string_view text, float* dst, std::string*) {
  return absl::SimpleAtof(text, dst);
}

bool AbslParseFlag(absl::string_view text, double* dst, std::string*) {
  return absl::SimpleAtod(text, dst);
}

// --------------------------------------------------------------------
// AbslParseFlag for strings.

bool AbslParseFlag(absl::string_view text, std::string* dst, std::string*) {
  dst->assign(text.data(), text.size());
  return true;
}

// --------------------------------------------------------------------
// AbslParseFlag for vector of strings.

bool AbslParseFlag(absl::string_view text, std::vector<std::string>* dst,
                   std::string*) {
  // An empty flag value corresponds to an empty vector, not a vector
  // with a single, empty std::string.
  if (text.empty()) {
    dst->clear();
    return true;
  }
  *dst = absl::StrSplit(text, ',', absl::AllowEmpty());
  return true;
}

// --------------------------------------------------------------------
// AbslUnparseFlag specializations for various builtin flag types.

std::string Unparse(bool v) { return v ? "true" : "false"; }
std::string Unparse(short v) { return absl::StrCat(v); }
std::string Unparse(unsigned short v) { return absl::StrCat(v); }
std::string Unparse(int v) { return absl::StrCat(v); }
std::string Unparse(unsigned int v) { return absl::StrCat(v); }
std::string Unparse(long v) { return absl::StrCat(v); }
std::string Unparse(unsigned long v) { return absl::StrCat(v); }
std::string Unparse(long long v) { return absl::StrCat(v); }
std::string Unparse(unsigned long long v) { return absl::StrCat(v); }
std::string Unparse(absl::int128 v) {
  std::stringstream ss;
  ss << v;
  return ss.str();
}
std::string Unparse(absl::uint128 v) {
  std::stringstream ss;
  ss << v;
  return ss.str();
}

template <typename T>
std::string UnparseFloatingPointVal(T v) {
  // digits10 is guaranteed to roundtrip correctly in string -> value -> string
  // conversions, but may not be enough to represent all the values correctly.
  std::string digit10_str =
      absl::StrFormat("%.*g", std::numeric_limits<T>::digits10, v);
  if (std::isnan(v) || std::isinf(v)) return digit10_str;

  T roundtrip_val = 0;
  std::string err;
  if (absl::ParseFlag(digit10_str, &roundtrip_val, &err) &&
      roundtrip_val == v) {
    return digit10_str;
  }

  // max_digits10 is the number of base-10 digits that are necessary to uniquely
  // represent all distinct values.
  return absl::StrFormat("%.*g", std::numeric_limits<T>::max_digits10, v);
}
std::string Unparse(float v) { return UnparseFloatingPointVal(v); }
std::string Unparse(double v) { return UnparseFloatingPointVal(v); }
std::string AbslUnparseFlag(absl::string_view v) { return std::string(v); }
std::string AbslUnparseFlag(const std::vector<std::string>& v) {
  return absl::StrJoin(v, ",");
}

}  // namespace flags_internal

bool AbslParseFlag(absl::string_view text, absl::LogSeverity* dst,
                   std::string* err) {
  text = absl::StripAsciiWhitespace(text);
  if (text.empty()) {
    *err = "no value provided";
    return false;
  }
  if (absl::EqualsIgnoreCase(text, "dfatal")) {
    *dst = absl::kLogDebugFatal;
    return true;
  }
  if (absl::EqualsIgnoreCase(text, "klogdebugfatal")) {
    *dst = absl::kLogDebugFatal;
    return true;
  }
  if (text.front() == 'k' || text.front() == 'K') text.remove_prefix(1);
  if (absl::EqualsIgnoreCase(text, "info")) {
    *dst = absl::LogSeverity::kInfo;
    return true;
  }
  if (absl::EqualsIgnoreCase(text, "warning")) {
    *dst = absl::LogSeverity::kWarning;
    return true;
  }
  if (absl::EqualsIgnoreCase(text, "error")) {
    *dst = absl::LogSeverity::kError;
    return true;
  }
  if (absl::EqualsIgnoreCase(text, "fatal")) {
    *dst = absl::LogSeverity::kFatal;
    return true;
  }
  std::underlying_type<absl::LogSeverity>::type numeric_value;
  if (absl::ParseFlag(text, &numeric_value, err)) {
    *dst = static_cast<absl::LogSeverity>(numeric_value);
    return true;
  }
  *err =
      "only integers, absl::LogSeverity enumerators, and DFATAL are accepted";
  return false;
}

std::string AbslUnparseFlag(absl::LogSeverity v) {
  if (v == absl::NormalizeLogSeverity(v)) return absl::LogSeverityName(v);
  return absl::UnparseFlag(static_cast<int>(v));
}

ABSL_NAMESPACE_END
}  // namespace absl

Coverage Report

Created: 2026-05-30 06:23

Line	Count	Source
1		//
2		// Copyright 2019 The Abseil Authors.
3		//
4		// Licensed under the Apache License, Version 2.0 (the "License");
5		// you may not use this file except in compliance with the License.
6		// You may obtain a copy of the License at
7		//
8		// https://www.apache.org/licenses/LICENSE-2.0
9		//
10		// Unless required by applicable law or agreed to in writing, software
11		// distributed under the License is distributed on an "AS IS" BASIS,
12		// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13		// See the License for the specific language governing permissions and
14		// limitations under the License.
15
16		#include "absl/flags/marshalling.h"
17
18		#include <stddef.h>
19
20		#include <cmath>
21		#include <limits>
22		#include <sstream>
23		#include <string>
24		#include <type_traits>
25		#include <vector>
26
27		#include "absl/base/config.h"
28		#include "absl/base/log_severity.h"
29		#include "absl/base/macros.h"
30		#include "absl/numeric/int128.h"
31		#include "absl/strings/ascii.h"
32		#include "absl/strings/match.h"
33		#include "absl/strings/numbers.h"
34		#include "absl/strings/str_cat.h"
35		#include "absl/strings/str_format.h"
36		#include "absl/strings/str_join.h"
37		#include "absl/strings/str_split.h"
38		#include "absl/strings/string_view.h"
39
40		namespace absl {
41		ABSL_NAMESPACE_BEGIN
42		namespace flags_internal {
43
44		// --------------------------------------------------------------------
45		// AbslParseFlag specializations for boolean type.
46
47	0	bool AbslParseFlag(absl::string_view text, bool* dst, std::string*) {
48	0	return SimpleAtob(absl::StripAsciiWhitespace(text), dst);
49	0	}
50
51		// --------------------------------------------------------------------
52		// AbslParseFlag for integral types.
53
54		// Return the base to use for parsing text as an integer. Leading 0x
55		// puts us in base 16. But leading 0 does not put us in base 8. It
56		// caused too many bugs when we had that behavior.
57	0	static int NumericBase(absl::string_view text) {
58	0	if (text.empty()) return 0;
59	0	size_t num_start = (text[0] == '-' \|\| text[0] == '+') ? 1 : 0;
60	0	const bool hex = (text.size() >= num_start + 2 && text[num_start] == '0' &&
61	0	(text[num_start + 1] == 'x' \|\| text[num_start + 1] == 'X'));
62	0	return hex ? 16 : 10;
63	0	}
64
65		template <typename IntType>
66	0	inline bool ParseFlagImpl(absl::string_view text, IntType& dst) {
67	0	text = absl::StripAsciiWhitespace(text);
68
69	0	return absl::numbers_internal::safe_strtoi_base(text, &dst,
70	0	NumericBase(text));
71	0	} Unexecuted instantiation: bool absl::lts_20260107::flags_internal::ParseFlagImpl<int>(std::__1::basic_string_view<char, std::__1::char_traits<char> >, int&) Unexecuted instantiation: bool absl::lts_20260107::flags_internal::ParseFlagImpl<unsigned int>(std::__1::basic_string_view<char, std::__1::char_traits<char> >, unsigned int&) Unexecuted instantiation: bool absl::lts_20260107::flags_internal::ParseFlagImpl<long>(std::__1::basic_string_view<char, std::__1::char_traits<char> >, long&) Unexecuted instantiation: bool absl::lts_20260107::flags_internal::ParseFlagImpl<unsigned long>(std::__1::basic_string_view<char, std::__1::char_traits<char> >, unsigned long&) Unexecuted instantiation: bool absl::lts_20260107::flags_internal::ParseFlagImpl<long long>(std::__1::basic_string_view<char, std::__1::char_traits<char> >, long long&) Unexecuted instantiation: bool absl::lts_20260107::flags_internal::ParseFlagImpl<unsigned long long>(std::__1::basic_string_view<char, std::__1::char_traits<char> >, unsigned long long&)
72
73	0	bool AbslParseFlag(absl::string_view text, short* dst, std::string*) {
74	0	int val;
75	0	if (!ParseFlagImpl(text, val)) return false;
76	0	if (static_cast<short>(val) != val) // worked, but number out of range
77	0	return false;
78	0	*dst = static_cast<short>(val);
79	0	return true;
80	0	}
81
82	0	bool AbslParseFlag(absl::string_view text, unsigned short* dst, std::string*) {
83	0	unsigned int val;
84	0	if (!ParseFlagImpl(text, val)) return false;
85	0	if (static_cast<unsigned short>(val) !=
86	0	val) // worked, but number out of range
87	0	return false;
88	0	*dst = static_cast<unsigned short>(val);
89	0	return true;
90	0	}
91
92	0	bool AbslParseFlag(absl::string_view text, int* dst, std::string*) {
93	0	return ParseFlagImpl(text, *dst);
94	0	}
95
96	0	bool AbslParseFlag(absl::string_view text, unsigned int* dst, std::string*) {
97	0	return ParseFlagImpl(text, *dst);
98	0	}
99
100	0	bool AbslParseFlag(absl::string_view text, long* dst, std::string*) {
101	0	return ParseFlagImpl(text, *dst);
102	0	}
103
104	0	bool AbslParseFlag(absl::string_view text, unsigned long* dst, std::string*) {
105	0	return ParseFlagImpl(text, *dst);
106	0	}
107
108	0	bool AbslParseFlag(absl::string_view text, long long* dst, std::string*) {
109	0	return ParseFlagImpl(text, *dst);
110	0	}
111
112		bool AbslParseFlag(absl::string_view text, unsigned long long* dst,
113	0	std::string*) {
114	0	return ParseFlagImpl(text, *dst);
115	0	}
116
117	0	bool AbslParseFlag(absl::string_view text, absl::int128* dst, std::string*) {
118	0	text = absl::StripAsciiWhitespace(text);
119
120		// check hex
121	0	int base = NumericBase(text);
122	0	if (!absl::numbers_internal::safe_strto128_base(text, dst, base)) {
123	0	return false;
124	0	}
125
126	0	return base == 16 ? absl::SimpleHexAtoi(text, dst)
127	0	: absl::SimpleAtoi(text, dst);
128	0	}
129
130	0	bool AbslParseFlag(absl::string_view text, absl::uint128* dst, std::string*) {
131	0	text = absl::StripAsciiWhitespace(text);
132
133		// check hex
134	0	int base = NumericBase(text);
135	0	if (!absl::numbers_internal::safe_strtou128_base(text, dst, base)) {
136	0	return false;
137	0	}
138
139	0	return base == 16 ? absl::SimpleHexAtoi(text, dst)
140	0	: absl::SimpleAtoi(text, dst);
141	0	}
142
143		// --------------------------------------------------------------------
144		// AbslParseFlag for floating point types.
145
146	0	bool AbslParseFlag(absl::string_view text, float* dst, std::string*) {
147	0	return absl::SimpleAtof(text, dst);
148	0	}
149
150	0	bool AbslParseFlag(absl::string_view text, double* dst, std::string*) {
151	0	return absl::SimpleAtod(text, dst);
152	0	}
153
154		// --------------------------------------------------------------------
155		// AbslParseFlag for strings.
156
157	0	bool AbslParseFlag(absl::string_view text, std::string* dst, std::string*) {
158	0	dst->assign(text.data(), text.size());
159	0	return true;
160	0	}
161
162		// --------------------------------------------------------------------
163		// AbslParseFlag for vector of strings.
164
165		bool AbslParseFlag(absl::string_view text, std::vector<std::string>* dst,
166	0	std::string*) {
167		// An empty flag value corresponds to an empty vector, not a vector
168		// with a single, empty std::string.
169	0	if (text.empty()) {
170	0	dst->clear();
171	0	return true;
172	0	}
173	0	*dst = absl::StrSplit(text, ',', absl::AllowEmpty());
174	0	return true;
175	0	}
176
177		// --------------------------------------------------------------------
178		// AbslUnparseFlag specializations for various builtin flag types.
179
180	0	std::string Unparse(bool v) { return v ? "true" : "false"; }
181	0	std::string Unparse(short v) { return absl::StrCat(v); }
182	0	std::string Unparse(unsigned short v) { return absl::StrCat(v); }
183	0	std::string Unparse(int v) { return absl::StrCat(v); }
184	0	std::string Unparse(unsigned int v) { return absl::StrCat(v); }
185	0	std::string Unparse(long v) { return absl::StrCat(v); }
186	0	std::string Unparse(unsigned long v) { return absl::StrCat(v); }
187	0	std::string Unparse(long long v) { return absl::StrCat(v); }
188	0	std::string Unparse(unsigned long long v) { return absl::StrCat(v); }
189	0	std::string Unparse(absl::int128 v) {
190	0	std::stringstream ss;
191	0	ss << v;
192	0	return ss.str();
193	0	}
194	0	std::string Unparse(absl::uint128 v) {
195	0	std::stringstream ss;
196	0	ss << v;
197	0	return ss.str();
198	0	}
199
200		template <typename T>
201	0	std::string UnparseFloatingPointVal(T v) {
202		// digits10 is guaranteed to roundtrip correctly in string -> value -> string
203		// conversions, but may not be enough to represent all the values correctly.
204	0	std::string digit10_str =
205	0	absl::StrFormat("%.*g", std::numeric_limits<T>::digits10, v);
206	0	if (std::isnan(v) \|\| std::isinf(v)) return digit10_str;
207
208	0	T roundtrip_val = 0;
209	0	std::string err;
210	0	if (absl::ParseFlag(digit10_str, &roundtrip_val, &err) &&
211	0	roundtrip_val == v) {
212	0	return digit10_str;
213	0	}
214
215		// max_digits10 is the number of base-10 digits that are necessary to uniquely
216		// represent all distinct values.
217	0	return absl::StrFormat("%.*g", std::numeric_limits<T>::max_digits10, v);
218	0	} Unexecuted instantiation: std::__1::basic_string<char, std::__1::char_traits<char>, std::__1::allocator<char> > absl::lts_20260107::flags_internal::UnparseFloatingPointVal<float>(float) Unexecuted instantiation: std::__1::basic_string<char, std::__1::char_traits<char>, std::__1::allocator<char> > absl::lts_20260107::flags_internal::UnparseFloatingPointVal<double>(double)
219	0	std::string Unparse(float v) { return UnparseFloatingPointVal(v); }
220	0	std::string Unparse(double v) { return UnparseFloatingPointVal(v); }
221	0	std::string AbslUnparseFlag(absl::string_view v) { return std::string(v); }
222	0	std::string AbslUnparseFlag(const std::vector<std::string>& v) {
223	0	return absl::StrJoin(v, ",");
224	0	}
225
226		} // namespace flags_internal
227
228		bool AbslParseFlag(absl::string_view text, absl::LogSeverity* dst,
229	0	std::string* err) {
230	0	text = absl::StripAsciiWhitespace(text);
231	0	if (text.empty()) {
232	0	*err = "no value provided";
233	0	return false;
234	0	}
235	0	if (absl::EqualsIgnoreCase(text, "dfatal")) {
236	0	*dst = absl::kLogDebugFatal;
237	0	return true;
238	0	}
239	0	if (absl::EqualsIgnoreCase(text, "klogdebugfatal")) {
240	0	*dst = absl::kLogDebugFatal;
241	0	return true;
242	0	}
243	0	if (text.front() == 'k' \|\| text.front() == 'K') text.remove_prefix(1);
244	0	if (absl::EqualsIgnoreCase(text, "info")) {
245	0	*dst = absl::LogSeverity::kInfo;
246	0	return true;
247	0	}
248	0	if (absl::EqualsIgnoreCase(text, "warning")) {
249	0	*dst = absl::LogSeverity::kWarning;
250	0	return true;
251	0	}
252	0	if (absl::EqualsIgnoreCase(text, "error")) {
253	0	*dst = absl::LogSeverity::kError;
254	0	return true;
255	0	}
256	0	if (absl::EqualsIgnoreCase(text, "fatal")) {
257	0	*dst = absl::LogSeverity::kFatal;
258	0	return true;
259	0	}
260	0	std::underlying_type<absl::LogSeverity>::type numeric_value;
261	0	if (absl::ParseFlag(text, &numeric_value, err)) {
262	0	*dst = static_cast<absl::LogSeverity>(numeric_value);
263	0	return true;
264	0	}
265	0	*err =
266	0	"only integers, absl::LogSeverity enumerators, and DFATAL are accepted";
267	0	return false;
268	0	}
269
270	0	std::string AbslUnparseFlag(absl::LogSeverity v) {
271	0	if (v == absl::NormalizeLogSeverity(v)) return absl::LogSeverityName(v);
272	0	return absl::UnparseFlag(static_cast<int>(v));
273	0	}
274
275		ABSL_NAMESPACE_END
276		} // namespace absl