Namespaces
namespace	internal

namespace	testing

namespace	win

Classes
class	AutoReset

struct	DefaultSingletonTraits

class	LogMessage

class	LogMessageVoidify

class	NoDestructor

class	scoped_nsobject

class	scoped_nsobject< id >

class	scoped_nsobject< NSAutoreleasePool >

class	scoped_nsprotocol

class	SimpleToken

Typedefs
using	SizeT = StrictNumeric< size_t >

Functions
template<class T , class Allocator , class Predicate >
size_t	EraseIf (std::vector< T, Allocator > &container, Predicate pred)

template<typename Container , typename Value >
bool	Contains (const Container &container, const Value &value)

template<typename T >
bool	Contains (const std::vector< T > &container, const T &value)

void	KillProcess ()

template<class T >
constexpr const T &	ClampToRange (const T &value, const T &min, const T &max)

template<typename T >
constexpr bool	IsApproximatelyEqual (T lhs, T rhs, T tolerance)

template<typename Dst = int, typename Src , typename = std::enable_if_t<std::is_integral<Dst>::value && std::is_floating_point<Src>::value>>
Dst	ClampFloor (Src value)

template<typename Dst = int, typename Src , typename = std::enable_if_t<std::is_integral<Dst>::value && std::is_floating_point<Src>::value>>
Dst	ClampCeil (Src value)

template<typename Dst = int, typename Src , typename = std::enable_if_t<std::is_integral<Dst>::value && std::is_floating_point<Src>::value>>
Dst	ClampRound (Src value)

template<class C >
void	swap (scoped_nsprotocol< C > &p1, scoped_nsprotocol< C > &p2)

template<class C >
bool	operator== (C p1, const scoped_nsprotocol< C > &p2)

template<class C >
bool	operator!= (C p1, const scoped_nsprotocol< C > &p2)

std::ostream &	operator<< (std::ostream &out, const SimpleToken &token)

std::optional< base::SimpleToken >	ValueToSimpleToken (std::string str)

std::string	SimpleTokenToValue (const SimpleToken &token)

size_t	SimpleTokenHash (const SimpleToken &SimpleToken)

std::u16string	ASCIIToUTF16 (std::string src)

std::u16string	UTF8ToUTF16 (std::string src)

std::string	UTF16ToUTF8 (std::u16string src)

std::u16string	NumberToString16 (float number)

std::u16string	NumberToString16 (int32_t number)

std::u16string	NumberToString16 (unsigned int number)

std::u16string	NumberToString16 (double number)

std::string	NumberToString (int32_t number)

std::string	NumberToString (unsigned int number)

std::string	NumberToString (float number)

std::string	NumberToString (double number)

std::string	JoinString (std::vector< std::string > tokens, std::string delimiter)

std::u16string	JoinString (std::vector< std::u16string > tokens, std::u16string delimiter)

void	ReplaceChars (std::string in, std::string from, std::string to, std::string *out)

void	ReplaceChars (std::u16string in, std::u16string from, std::u16string to, std::u16string *out)

const std::string &	EmptyString ()

std::string	ToUpperASCII (std::string str)

std::string	ToLowerASCII (std::string str)

bool	LowerCaseEqualsASCII (std::string a, std::string b)

bool	ContainsOnlyChars (std::u16string str, char16_t ch)

template<typename... Args>
std::string	StringPrintf (const std::string &format, Args... args)

	TEST (StringUtilsTest, StringPrintfEmpty)

	TEST (StringUtilsTest, StringPrintfMisc)

	TEST (StringUtilsTest, StringPrintfErrno)

	TEST (StringUtilsTest, canASCIIToUTF16)

	TEST (StringUtilsTest, canUTF8ToUTF16)

	TEST (StringUtilsTest, canUTF16ToUTF8)

	TEST (StringUtilsTest, canNumberToString16)

	TEST (StringUtilsTest, numberToStringSimplifiesOutput)

Variables
constexpr double	kPiDouble = 3.14159265358979323846

constexpr float	kPiFloat = 3.14159265358979323846f

constexpr double	kMeanGravityDouble = 9.80665

constexpr float	kMeanGravityFloat = 9.80665f

constexpr size_t	kRandomTokenLength = 10

constexpr char16_t	kWhitespaceUTF16 = u' '

Typedef Documentation

◆ SizeT

using base::SizeT = typedef StrictNumeric<size_t>

Definition at line 357 of file safe_conversions.h.

Function Documentation

◆ ASCIIToUTF16()

std::u16string base::ASCIIToUTF16 ( std::string src )

Definition at line 63 of file string_utils.cc.

                                         {
  return std::u16string(src.begin(), src.end());
}

◆ ClampCeil()

template<typename Dst = int, typename Src , typename = std::enable_if_t<std::is_integral<Dst>::value && std::is_floating_point<Src>::value>>

Dst base::ClampCeil ( Src value )

Definition at line 373 of file safe_conversions.h.

                         {
  return saturated_cast<Dst>(std::ceil(value));
}

◆ ClampFloor()

template<typename Dst = int, typename Src , typename = std::enable_if_t<std::is_integral<Dst>::value && std::is_floating_point<Src>::value>>

Dst base::ClampFloor ( Src value )

Definition at line 366 of file safe_conversions.h.

                          {
  return saturated_cast<Dst>(std::floor(value));
}

◆ ClampRound()

template<typename Dst = int, typename Src , typename = std::enable_if_t<std::is_integral<Dst>::value && std::is_floating_point<Src>::value>>

Dst base::ClampRound ( Src value )

Definition at line 380 of file safe_conversions.h.

                          {
  const Src rounded =
      (value >= 0.0f) ? std::floor(value + 0.5f) : std::ceil(value - 0.5f);
  return saturated_cast<Dst>(rounded);
}

◆ ClampToRange()

template<class T >

constexpr const T & base::ClampToRange	(	const T &	value,
		const T &	min,
		const T &	max
	)

constexpr

Definition at line 15 of file ranges.h.

                                                                            {
  return std::min(std::max(value, min), max);
}

◆ Contains() [1/2]

template<typename Container , typename Value >

bool base::Contains	(	const Container &	container,
		const Value &	value
	)

Definition at line 22 of file container_utils.h.

                                                              {
  return container.find(value) != container.end();
}

◆ Contains() [2/2]

template<typename T >

bool base::Contains	(	const std::vector< T > &	container,
		const T &	value
	)

Definition at line 27 of file container_utils.h.

                                                             {
  return std::find(container.begin(), container.end(), value) !=
         container.end();
}

◆ ContainsOnlyChars()

bool base::ContainsOnlyChars	(	std::u16string	str,
		char16_t	ch
	)

Definition at line 183 of file string_utils.cc.

                                                      {
  return std::find_if(str.begin(), str.end(),
                      [ch](char16_t c) { return c != ch; }) == str.end();
}

◆ EmptyString()

const std::string & base::EmptyString ( )

Definition at line 157 of file string_utils.cc.

                               {
  static const base::NoDestructor<std::string> s;
  return *s;
}

◆ EraseIf()

template<class T , class Allocator , class Predicate >

size_t base::EraseIf	(	std::vector< T, Allocator > &	container,
		Predicate	pred
	)

Definition at line 14 of file container_utils.h.

                                                                   {
  auto it = std::remove_if(container.begin(), container.end(), pred);
  size_t removed = std::distance(it, container.end());
  container.erase(it, container.end());
  return removed;
}

◆ IsApproximatelyEqual()

template<typename T >

constexpr bool base::IsApproximatelyEqual	(	T	lhs,
		T	rhs,
		T	tolerance
	)

constexpr

Definition at line 20 of file ranges.h.

                                                               {
  static_assert(std::is_arithmetic<T>::value, "Argument must be arithmetic");
  return std::abs(rhs - lhs) <= tolerance;
}

◆ JoinString() [1/2]

std::string base::JoinString	(	std::vector< std::string >	tokens,
		std::string	delimiter
	)

Definition at line 107 of file string_utils.cc.

                                                                       {
  std::ostringstream imploded;
  for (size_t i = 0; i < tokens.size(); i++) {
    if (i == tokens.size() - 1) {
      imploded << tokens[i];
    } else {
      imploded << tokens[i] << delimiter;
    }
  }
  return imploded.str();
}

◆ JoinString() [2/2]

std::u16string base::JoinString	(	std::vector< std::u16string >	tokens,
		std::u16string	delimiter
	)

Definition at line 119 of file string_utils.cc.

                                                  {
  std::u16string result;
  for (size_t i = 0; i < tokens.size(); i++) {
    if (i == tokens.size() - 1) {
      result.append(tokens[i]);
    } else {
      result.append(tokens[i]);
      result.append(delimiter);
    }
  }
  return result;
}

◆ KillProcess()

void base::KillProcess ( )

Definition at line 61 of file logging.cc.

                   {
  abort();
}

◆ LowerCaseEqualsASCII()

bool base::LowerCaseEqualsASCII	(	std::string	a,
		std::string	b
	)

Definition at line 178 of file string_utils.cc.

                                                    {
  std::string lower_a = ToLowerASCII(a);
  return lower_a.compare(ToLowerASCII(b)) == 0;
}

◆ NumberToString() [1/4]

std::string base::NumberToString ( double number )

Definition at line 103 of file string_utils.cc.

                                        {
  return NumberToStringImpl(number, false);
}

◆ NumberToString() [2/4]

std::string base::NumberToString ( float number )

Definition at line 99 of file string_utils.cc.

                                       {
  return NumberToStringImpl(number, true);
}

◆ NumberToString() [3/4]

std::string base::NumberToString ( int32_t number )

Definition at line 91 of file string_utils.cc.

                                         {
  return std::to_string(number);
}

◆ NumberToString() [4/4]

std::string base::NumberToString ( unsigned int number )

Definition at line 95 of file string_utils.cc.

                                              {
  return std::to_string(number);
}

◆ NumberToString16() [1/4]

std::u16string base::NumberToString16 ( double number )

Definition at line 87 of file string_utils.cc.

                                             {
  return ASCIIToUTF16(NumberToString(number));
}

◆ NumberToString16() [2/4]

std::u16string base::NumberToString16 ( float number )

Definition at line 75 of file string_utils.cc.

                                            {
  return ASCIIToUTF16(NumberToString(number));
}

◆ NumberToString16() [3/4]

std::u16string base::NumberToString16 ( int32_t number )

Definition at line 79 of file string_utils.cc.

                                              {
  return ASCIIToUTF16(NumberToString(number));
}

◆ NumberToString16() [4/4]

std::u16string base::NumberToString16 ( unsigned int number )

Definition at line 83 of file string_utils.cc.

                                                   {
  return ASCIIToUTF16(NumberToString(number));
}

◆ operator!=()

template<class C >

bool base::operator!=	(	C	p1,
		const scoped_nsprotocol< C > &	p2
	)

Definition at line 107 of file scoped_nsobject.h.

                                                      {
  return p1 != p2.get();
}

◆ operator<<()

std::ostream & base::operator<<	(	std::ostream &	out,
		const SimpleToken &	token
	)

Definition at line 31 of file simple_token.cc.

                                                                  {
  return out << "(" << token.ToString() << ")";
}

◆ operator==()

template<class C >

bool base::operator==	(	C	p1,
		const scoped_nsprotocol< C > &	p2
	)

Definition at line 102 of file scoped_nsobject.h.

                                                      {
  return p1 == p2.get();
}

◆ ReplaceChars() [1/2]

void base::ReplaceChars	(	std::string	in,
		std::string	from,
		std::string	to,
		std::string *	out
	)

Definition at line 133 of file string_utils.cc.

                                  {
  size_t pos = in.find(from);
  while (pos != std::string::npos) {
    in.replace(pos, from.size(), to);
    pos = in.find(from, pos + to.size());
  }
  *out = in;
}

◆ ReplaceChars() [2/2]

void base::ReplaceChars	(	std::u16string	in,
		std::u16string	from,
		std::u16string	to,
		std::u16string *	out
	)

Definition at line 145 of file string_utils.cc.

                                     {
  size_t pos = in.find(from);
  while (pos != std::u16string::npos) {
    in.replace(pos, from.size(), to);
    pos = in.find(from, pos + to.size());
  }
  *out = in;
}

◆ SimpleTokenHash()

size_t base::SimpleTokenHash ( const SimpleToken & SimpleToken )

Definition at line 43 of file simple_token.cc.

                                                       {
  return std::hash<std::string>()(SimpleToken.ToString());
}

◆ SimpleTokenToValue()

std::string base::SimpleTokenToValue ( const SimpleToken & token )

Definition at line 39 of file simple_token.cc.

                                                       {
  return token.ToString();
}

◆ StringPrintf()

template<typename... Args>

std::string base::StringPrintf	(	const std::string &	format,
		Args...	args
	)

Definition at line 18 of file string_utils.h.

                                                              {
  // Calculate the buffer size.
  int size = snprintf(nullptr, 0, format.c_str(), args...) + 1;
  std::unique_ptr<char[]> buf = std::make_unique<char[]>(size);
  snprintf(buf.get(), size, format.c_str(), args...);
  return std::string(buf.get(), buf.get() + size - 1);
}

◆ swap()

template<class C >

void base::swap	(	scoped_nsprotocol< C > &	p1,
		scoped_nsprotocol< C > &	p2
	)

Definition at line 97 of file scoped_nsobject.h.

                                                              {
  p1.swap(p2);
}

◆ TEST() [1/8]

base::TEST	(	StringUtilsTest	,
		canASCIIToUTF16
	)

Definition at line 30 of file string_utils_unittest.cc.

                                       {
  std::string ascii = "abcdefg";
  EXPECT_EQ(ASCIIToUTF16(ascii).compare(u"abcdefg"), 0);
}

◆ TEST() [2/8]

base::TEST	(	StringUtilsTest	,
		canNumberToString16
	)

Definition at line 45 of file string_utils_unittest.cc.

                                           {
  EXPECT_EQ(NumberToString16(1.123f), std::u16string(u"1.123"));
}

◆ TEST() [3/8]

base::TEST	(	StringUtilsTest	,
		canUTF16ToUTF8
	)

Definition at line 40 of file string_utils_unittest.cc.

                                      {
  std::u16string utf16 = u"äåè";
  EXPECT_EQ(UTF16ToUTF8(utf16).compare("äåè"), 0);
}

◆ TEST() [4/8]

base::TEST	(	StringUtilsTest	,
		canUTF8ToUTF16
	)

Definition at line 35 of file string_utils_unittest.cc.

                                      {
  std::string utf8 = "äåè";
  EXPECT_EQ(UTF8ToUTF16(utf8).compare(u"äåè"), 0);
}

◆ TEST() [5/8]

base::TEST	(	StringUtilsTest	,
		numberToStringSimplifiesOutput
	)

Definition at line 49 of file string_utils_unittest.cc.

                                                      {
  EXPECT_STREQ(NumberToString(0.0).c_str(), "0");
  EXPECT_STREQ(NumberToString(0.0f).c_str(), "0");
  EXPECT_STREQ(NumberToString(1.123).c_str(), "1.123");
  EXPECT_STREQ(NumberToString(1.123f).c_str(), "1.123");
  EXPECT_STREQ(NumberToString(-1.123).c_str(), "-1.123");
  EXPECT_STREQ(NumberToString(-1.123f).c_str(), "-1.123");
  EXPECT_STREQ(NumberToString(1.00001).c_str(), "1.00001");
  EXPECT_STREQ(NumberToString(1.00001f).c_str(), "1.00001");
  EXPECT_STREQ(NumberToString(1000.000001).c_str(), "1000.000001");
  EXPECT_STREQ(NumberToString(10.00001f).c_str(), "10.00001");
  EXPECT_STREQ(NumberToString(1.0 + 1e-8).c_str(), "1.00000001");
  EXPECT_STREQ(NumberToString(1.0f + 1e-8f).c_str(), "1");
  EXPECT_STREQ(NumberToString(1e-6).c_str(), "0.000001");
  EXPECT_STREQ(NumberToString(1e-6f).c_str(), "0.000001");
  EXPECT_STREQ(NumberToString(1e-8).c_str(), "1e-8");
  EXPECT_STREQ(NumberToString(1e-8f).c_str(), "1e-8");
  EXPECT_STREQ(NumberToString(100.0).c_str(), "100");
  EXPECT_STREQ(NumberToString(100.0f).c_str(), "100");
  EXPECT_STREQ(NumberToString(-1.0 - 1e-7).c_str(), "-1.0000001");
  EXPECT_STREQ(NumberToString(-1.0f - 1e-7f).c_str(), "-1.0000001");
  EXPECT_STREQ(NumberToString(0.00000012345678).c_str(), "1.2345678e-7");
  // Difference in output is due to differences in double and float precision.
  EXPECT_STREQ(NumberToString(0.00000012345678f).c_str(), "1.2345679e-7");
  EXPECT_STREQ(NumberToString(-0.00000012345678).c_str(), "-1.2345678e-7");
  // Difference in output is due to differences in double and float precision.
  EXPECT_STREQ(NumberToString(-0.00000012345678f).c_str(), "-1.2345679e-7");
  EXPECT_STREQ(NumberToString(static_cast<unsigned int>(11)).c_str(), "11");
  EXPECT_STREQ(NumberToString(static_cast<int32_t>(-23)).c_str(), "-23");
}

◆ TEST() [6/8]

base::TEST	(	StringUtilsTest	,
		StringPrintfEmpty
	)

Definition at line 16 of file string_utils_unittest.cc.

                                         {
  EXPECT_EQ("", base::StringPrintf("%s", ""));
}

◆ TEST() [7/8]

base::TEST	(	StringUtilsTest	,
		StringPrintfErrno
	)

Definition at line 24 of file string_utils_unittest.cc.

                                         {
  errno = 1;
  EXPECT_EQ("", StringPrintf("%s", ""));
  EXPECT_EQ(1, errno);
}

◆ TEST() [8/8]

base::TEST	(	StringUtilsTest	,
		StringPrintfMisc
	)

Definition at line 20 of file string_utils_unittest.cc.

                                        {
  EXPECT_EQ("123hello w", StringPrintf("%3d%2s %1c", 123, "hello", 'w'));
}

◆ ToLowerASCII()

std::string base::ToLowerASCII ( std::string str )

Definition at line 170 of file string_utils.cc.

                                      {
  std::string ret;
  ret.reserve(str.size());
  for (size_t i = 0; i < str.size(); i++)
    ret.push_back(std::tolower(str[i]));
  return ret;
}

◆ ToUpperASCII()

std::string base::ToUpperASCII ( std::string str )

Definition at line 162 of file string_utils.cc.

                                      {
  std::string ret;
  ret.reserve(str.size());
  for (size_t i = 0; i < str.size(); i++)
    ret.push_back(std::toupper(str[i]));
  return ret;
}

◆ UTF16ToUTF8()

std::string base::UTF16ToUTF8 ( std::u16string src )

Definition at line 71 of file string_utils.cc.

                                        {
  return fml::Utf16ToUtf8(src);
}

◆ UTF8ToUTF16()

std::u16string base::UTF8ToUTF16 ( std::string src )

Definition at line 67 of file string_utils.cc.

                                        {
  return fml::Utf8ToUtf16(src);
}

◆ ValueToSimpleToken()

std::optional< base::SimpleToken > base::ValueToSimpleToken ( std::string str )

Definition at line 35 of file simple_token.cc.

                                                               {
  return std::make_optional<base::SimpleToken>(str);
}

Variable Documentation

◆ kMeanGravityDouble

constexpr double base::kMeanGravityDouble = 9.80665

constexpr

Definition at line 14 of file math_constants.h.

◆ kMeanGravityFloat

constexpr float base::kMeanGravityFloat = 9.80665f

constexpr

Definition at line 15 of file math_constants.h.

◆ kPiDouble

constexpr double base::kPiDouble = 3.14159265358979323846

constexpr

Definition at line 10 of file math_constants.h.

◆ kPiFloat

constexpr float base::kPiFloat = 3.14159265358979323846f

constexpr

Definition at line 11 of file math_constants.h.

◆ kRandomTokenLength

constexpr size_t base::kRandomTokenLength = 10

constexpr

Definition at line 12 of file simple_token.cc.

◆ kWhitespaceUTF16

constexpr char16_t base::kWhitespaceUTF16 = u' '

constexpr

Definition at line 14 of file string_utils.h.

Namespaces

Classes

Typedefs

Functions

Variables

Typedef Documentation

◆ SizeT

Function Documentation

◆ ASCIIToUTF16()

◆ ClampCeil()

◆ ClampFloor()

◆ ClampRound()

◆ ClampToRange()

◆ Contains() [1/2]

◆ Contains() [2/2]

◆ ContainsOnlyChars()

◆ EmptyString()

◆ EraseIf()

◆ IsApproximatelyEqual()

◆ JoinString() [1/2]

◆ JoinString() [2/2]

◆ KillProcess()

◆ LowerCaseEqualsASCII()

◆ NumberToString() [1/4]

◆ NumberToString() [2/4]

◆ NumberToString() [3/4]

◆ NumberToString() [4/4]

◆ NumberToString16() [1/4]

◆ NumberToString16() [2/4]

◆ NumberToString16() [3/4]

◆ NumberToString16() [4/4]

◆ operator!=()

◆ operator<<()

◆ operator==()

◆ ReplaceChars() [1/2]

◆ ReplaceChars() [2/2]

◆ SimpleTokenHash()

◆ SimpleTokenToValue()

◆ StringPrintf()

◆ swap()

◆ TEST() [1/8]

◆ TEST() [2/8]

◆ TEST() [3/8]

◆ TEST() [4/8]

◆ TEST() [5/8]

◆ TEST() [6/8]

◆ TEST() [7/8]

◆ TEST() [8/8]

◆ ToLowerASCII()

◆ ToUpperASCII()

◆ UTF16ToUTF8()

◆ UTF8ToUTF16()

◆ ValueToSimpleToken()

Variable Documentation

◆ kMeanGravityDouble

◆ kMeanGravityFloat

◆ kPiDouble

◆ kPiFloat

◆ kRandomTokenLength

◆ kWhitespaceUTF16