StringUtils.h File Reference

#include <algorithm>
#include <cstring>
#include <cwchar>
#include <string>
#include <string_view>
#include <type_traits>
#include <numeric>
#include <wx/string.h>

Include dependency graph for StringUtils.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Namespaces
namespace	details

Functions
std::size_t	StringLength (const char str)
std::size_t	StringLength (const wchar_t str)
std::size_t	StringLength (const char *str)
std::size_t	StringLength (const wchar_t *str)
template<typename CharType , size_t N>
std::size_t	StringLength (const CharType(&)[N])
template<typename StringType >
std::size_t	StringLength (const StringType &str)
template<template< typename, typename... > typename ContainerType, typename ResultType , typename SeparatorType , typename... Rest>
ResultType	Join (const ContainerType< ResultType, Rest... > &container, const SeparatorType &separator)
STRING_UTILS_API std::string	ToLower (const std::string &str)
STRING_UTILS_API std::string	ToLower (const std::string_view &str)
STRING_UTILS_API std::string	ToLower (const char *str)
STRING_UTILS_API std::wstring	ToLower (const std::wstring &str)
STRING_UTILS_API std::wstring	ToLower (const std::wstring_view &str)
STRING_UTILS_API std::wstring	ToLower (const wchar_t *str)
STRING_UTILS_API wxString	ToLower (const wxString &str)
STRING_UTILS_API std::string	ToUpper (const std::string &str)
STRING_UTILS_API std::string	ToUpper (const std::string_view &str)
STRING_UTILS_API std::string	ToUpper (const char *str)
STRING_UTILS_API std::wstring	ToUpper (const std::wstring &str)
STRING_UTILS_API std::wstring	ToUpper (const std::wstring_view &str)
STRING_UTILS_API std::wstring	ToUpper (const wchar_t *str)
STRING_UTILS_API wxString	ToUpper (const wxString &str)
const char *	details::begin (const char *str) noexcept
const char *	details::end (const char *str) noexcept
const wchar_t *	details::begin (const wchar_t *str) noexcept
const wchar_t *	details::end (const wchar_t *str) noexcept
template<typename HayType , typename PrefixType >
bool	IsPrefixed (const HayType &hay, const PrefixType &prefix)
template<typename HayType , typename PrefixType >
bool	IsPrefixedInsensitive (const HayType &hay, const PrefixType &prefix)

Function Documentation

IsPrefixed()

template<typename HayType , typename PrefixType >

bool IsPrefixed	(	const HayType &	hay,
		const PrefixType &	prefix
	)

Definition at line 129 of file StringUtils.h.

{
   if (StringLength(hay) < StringLength(prefix))
        return false;
 
   using namespace std;
   using namespace details;
 
   const auto prefixBegin = begin(prefix);
   const auto prefixEnd = end(prefix);
   const auto hayBegin = begin(hay);
 
   return std::mismatch(prefixBegin, prefixEnd, hayBegin).first == prefixEnd;
}

References details::begin(), details::end(), and StringLength().

Referenced by audacity::cloud::audiocom::OAuthService::HandleLinkURI(), IsPrefixedInsensitive(), and TEST_CASE().

Here is the call graph for this function:

Here is the caller graph for this function:

IsPrefixedInsensitive()

template<typename HayType , typename PrefixType >

bool IsPrefixedInsensitive	(	const HayType &	hay,
		const PrefixType &	prefix
	)

Definition at line 146 of file StringUtils.h.

{
   return IsPrefixed(ToLower(hay), ToLower(prefix));
}

References IsPrefixed(), and ToLower().

Referenced by audacity::cloud::audiocom::OAuthService::HandleLinkURI(), and TEST_CASE().

Here is the call graph for this function:

Here is the caller graph for this function:

Join()

template<template< typename, typename... > typename ContainerType, typename ResultType , typename SeparatorType , typename... Rest>

ResultType Join	(	const ContainerType< ResultType, Rest... > &	container,
		const SeparatorType &	separator
	)

Definition at line 52 of file StringUtils.h.

{
   if (container.empty())
      return ResultType {};
 
   const auto sepratorLength = StringLength(separator);
   const auto totalSeparatorLength = sepratorLength * (container.size() - 1);
 
   ResultType result;
 
    const auto size = std::accumulate(
       container.begin(), container.end(), totalSeparatorLength,
       [](size_t size, const ResultType& item)
       { return size + StringLength(item); });
 
    result.reserve(size);
 
    bool first = true;
    for (const auto& item : container)
    {
        if (!first)
            result += separator;
        result += item;
        first = false;
    }
 
    return result;
}

References size, and StringLength().

Referenced by TranslatableString::operator+=(), and TEST_CASE().

Here is the call graph for this function:

Here is the caller graph for this function:

StringLength() [1/6]

std::size_t StringLength ( const char *  str )

inline

Definition at line 29 of file StringUtils.h.

{
   return std::strlen(str);
}

References str.

StringLength() [2/6]

std::size_t StringLength ( const char  str )

inline

Definition at line 19 of file StringUtils.h.

{
   return 1;
}

Referenced by details::end(), IsPrefixed(), and Join().

Here is the caller graph for this function:

StringLength() [3/6]

template<typename CharType , size_t N>

std::size_t StringLength

(

const

CharType(&)[N]

)

Definition at line 40 of file StringUtils.h.

{
   return N - 1;
}

StringLength() [4/6]

template<typename StringType >

std::size_t StringLength

(

const StringType &

str

)

Definition at line 46 of file StringUtils.h.

{
   return str.length();
}

References str.

StringLength() [5/6]

std::size_t StringLength ( const wchar_t *  str )

inline

Definition at line 34 of file StringUtils.h.

{
   return std::wcslen(str);
}

References str.

StringLength() [6/6]

std::size_t StringLength ( const wchar_t  str )

inline

Definition at line 24 of file StringUtils.h.

{
   return 1;
}

ToLower() [1/7]

STRING_UTILS_API std::string ToLower

(

const char *

str

)

Definition at line 21 of file StringUtils.cpp.

{
   return audacity::ToUTF8(ToLower(audacity::ToWXString(str)));
}

References str, ToLower(), audacity::ToUTF8(), and audacity::ToWXString().

Here is the call graph for this function:

ToLower() [2/7]

STRING_UTILS_API std::string ToLower

(

const std::string &

str

)

Definition at line 11 of file StringUtils.cpp.

{
   return audacity::ToUTF8(ToLower(audacity::ToWXString(str)));
}

References str, ToLower(), audacity::ToUTF8(), and audacity::ToWXString().

Referenced by IsPrefixedInsensitive(), and ToLower().

Here is the call graph for this function:

Here is the caller graph for this function:

ToLower() [3/7]

STRING_UTILS_API std::string ToLower

(

const std::string_view &

str

)

Definition at line 16 of file StringUtils.cpp.

{
   return audacity::ToUTF8(ToLower(audacity::ToWXString(str)));
}

References str, ToLower(), audacity::ToUTF8(), and audacity::ToWXString().

Here is the call graph for this function:

ToLower() [4/7]

STRING_UTILS_API std::wstring ToLower

(

const std::wstring &

str

)

Definition at line 26 of file StringUtils.cpp.

{
   return audacity::ToWString(ToLower(audacity::ToWXString(str)));
}

References str, ToLower(), audacity::ToWString(), and audacity::ToWXString().

Here is the call graph for this function:

ToLower() [5/7]

STRING_UTILS_API std::wstring ToLower

(

const std::wstring_view &

str

)

Definition at line 31 of file StringUtils.cpp.

{
   return audacity::ToWString(ToLower(audacity::ToWXString(str)));
}

References str, ToLower(), audacity::ToWString(), and audacity::ToWXString().

Here is the call graph for this function:

ToLower() [6/7]

STRING_UTILS_API std::wstring ToLower

(

const wchar_t *

str

)

Definition at line 36 of file StringUtils.cpp.

{
   return audacity::ToWString(ToLower(audacity::ToWXString(str)));
}

References str, ToLower(), audacity::ToWString(), and audacity::ToWXString().

Here is the call graph for this function:

ToLower() [7/7]

STRING_UTILS_API wxString ToLower

(

const wxString &

str

)

Definition at line 41 of file StringUtils.cpp.

{
   return str.Lower();
}

References str.

ToUpper() [1/7]

STRING_UTILS_API std::string ToUpper

(

const char *

str

)

Definition at line 56 of file StringUtils.cpp.

{
   return audacity::ToUTF8(ToUpper(audacity::ToWXString(str)));
}

References str, ToUpper(), audacity::ToUTF8(), and audacity::ToWXString().

Here is the call graph for this function:

ToUpper() [2/7]

STRING_UTILS_API std::string ToUpper

(

const std::string &

str

)

Definition at line 46 of file StringUtils.cpp.

{
   return audacity::ToUTF8(ToUpper(audacity::ToWXString(str)));
}

References str, ToUpper(), audacity::ToUTF8(), and audacity::ToWXString().

Referenced by audacity::cloud::audiocom::sync::RemoteProjectSnapshot::CalculateKnownBlocks(), audacity::cloud::audiocom::sync::RemoteProjectSnapshot::CleanupOrphanBlocks(), audacity::cloud::audiocom::sync::LocalProjectSnapshot::ProjectBlocksLock::FillMissingBlocks(), audacity::cloud::audiocom::sync::RemoteProjectSnapshot::RemoteProjectSnapshot(), and ToUpper().

Here is the call graph for this function:

Here is the caller graph for this function:

ToUpper() [3/7]

STRING_UTILS_API std::string ToUpper

(

const std::string_view &

str

)

Definition at line 51 of file StringUtils.cpp.

{
   return audacity::ToUTF8(ToUpper(audacity::ToWXString(str)));
}

References str, ToUpper(), audacity::ToUTF8(), and audacity::ToWXString().

Here is the call graph for this function:

ToUpper() [4/7]

STRING_UTILS_API std::wstring ToUpper

(

const std::wstring &

str

)

Definition at line 61 of file StringUtils.cpp.

{
   return audacity::ToWString(ToUpper(audacity::ToWXString(str)));
}

References str, ToUpper(), audacity::ToWString(), and audacity::ToWXString().

Here is the call graph for this function:

ToUpper() [5/7]

STRING_UTILS_API std::wstring ToUpper

(

const std::wstring_view &

str

)

Definition at line 66 of file StringUtils.cpp.

{
   return audacity::ToWString(ToUpper(audacity::ToWXString(str)));
}

References str, ToUpper(), audacity::ToWString(), and audacity::ToWXString().

Here is the call graph for this function:

ToUpper() [6/7]

STRING_UTILS_API std::wstring ToUpper

(

const wchar_t *

str

)

Definition at line 71 of file StringUtils.cpp.

{
   return audacity::ToWString(ToUpper(audacity::ToWXString(str)));
}

References str, ToUpper(), audacity::ToWString(), and audacity::ToWXString().

Here is the call graph for this function:

ToUpper() [7/7]

STRING_UTILS_API wxString ToUpper

(

const wxString &

str

)

Definition at line 76 of file StringUtils.cpp.

{
   return str.Upper();
}

References str.