<string>

Backports related to Standard header <string>

#include <cxxomfort/string.hpp>
// or as part of:
#include <cxxomfort/backports.hpp>

Interfaces

Interfaces defined in this section:

• to_string() (C++11) - convert C++ integers/floats into strings.
• Overloads include to_string(short) , to_string(long) , to_string(double) etc, for the compilers that missed some overloads (eg.: MSVC 2010).
• strtoll() , strtoull() function family (C++11) - convert strings into long s , for the compilers that missed them (MSVC).
• hash<> specialization for std::basic_string where not available.
• User-Defined Literal Support (C++14) - backports ""s to C++11.

Interfaces not in std:

• String helper , for systems where UDL is not available.
• String nonmember helpers , to supplement the new methods in C++20.

"s" user-defined literal

C++14 onwards defines operator"" s as the user-defined literal to create basic_string objects. The cxxomfort library backports the string and wstring capable versions to C++11, directly into namespace std (as std::literals::s).

using namespace std::literals; // or using namespace cxxomfort::fix
auto s2 = L"Hello World"s; // is a std::wstring

Warning

The compiler might issue a warning or an error in C++11 mode that the literal ""s is reserved. While this means the library can add the backport correctly, it could be that the compiler is blocking its use. It is compiler-dependent whether it is possible to disable this warning or error (see eg.: https://stackoverflow.com/questions/31509434/gcc-does-not-honor-pragma-gcc-diagnostic-to-silence-warnings ).

Note

To try and bypass this error use one of the following options:

• add the cxxomfort include directory to system headers eg.: -isystem.
• code intended to be cross-Standard compatible should be using cxxomfort::fix::s() instead (see the next section).

"s" helper

The helper function s() creates a basic_string . It is provided to serve as a supplement to the "user-defined literal" ""s where it is not available:

using cxxomfort::fix::s; // or using namespace cxxomfort::fix
auto s1 = s("Hello World");
using namespace std::literals;
auto s2 = "Hello World"s;
static_assert( std::is_same< decltype(s1) , decltype(s2) >::value, "?");

"basic_string nonmember helpers"

C++20 adds new member functions to basic_string and basic_string_view. Since it is not possible in C++ to extend a class with new methods, and the interface for basic_string is already crap (see []), cxxomfort implements them as nonmember accessors à-la-<iterator>.

For relevant documentation see Nonmember helpers for string types .

See Also

• See also

  header/string @ cppreference (cppreference)

• See also

  string_view backports

• See also

  cxxo-sup-string

  Member cxxomfort::cxxostd::to_string (NativeType)

  Member cxxomfort::string::clear (std::basic_string< Ch, ChT, A > &str) CXXO_NOEXCEPT

  Nonmember string helpers

  File string.hpp