ALib C++ Library
Library Version: 2510 R0
Documentation generated by doxygen
Loading...
Searching...
No Matches
alib::strings::compatibility::std Namespace Reference

Description:

This namespace documents compatibility features of ALib Strings and the standard C++ class library found in namespace std.

Type Index:

struct  equal_to< alib::strings::TString< TChar > >
 
struct  equal_to_string_ignore_case
 
struct  formatter< alib::strings::Appendable< TAppendable >, TChar >
 
struct  formatter< alib::strings::TAString< TChar, TAllocator >, TChar >
 
struct  formatter< alib::strings::TCString< TChar >, TChar >
 
struct  formatter< alib::strings::TLocalString< TChar, TCapacity, TAllocator >, TChar >
 
struct  formatter< alib::strings::TString< TChar >, TChar >
 
struct  formatter< alib::strings::TSubstring< TChar >, TChar >
 
struct  hash< alib::strings::TString< TChar > >
 
struct  hash_string_ignore_case
 
struct  less< alib::strings::TString< TChar > >
 
struct  less_string_ignore_case
 
class  StringReader
 
class  StringWriter
 
struct  SuppressStdOStreamOpTraits
 
struct  TISReadLine
 

Function Index:

ALIB_EXPORT std::ostream & operator<< (std::ostream &stream, const alib::NString &string)
 
ALIB_EXPORT ALIB_DLL std::ostream & operator<< (std::ostream &stream, const alib::WString &string)
 
template<typename TAppendable>
requires ( alib::strings::IsAppendable<TAppendable,alib::nchar,alib::lang::HeapAllocator> && !alib::strings::compatibility::std::SuppressStdOStreamOpTraits<TAppendable>::value )
ALIB_EXPORT std::ostream & operator<< (std::ostream &stream, const TAppendable &appendable)
 
ALIB_EXPORT std::ostream * operator<< (std::ostream *stream, const alib::NString &string)
 
ALIB_EXPORT std::ostream * operator<< (std::ostream *stream, const alib::WString &string)
 
template<typename TAppendable>
requires ( alib::strings::IsAppendable<TAppendable,alib::nchar,alib::lang::HeapAllocator> && !alib::strings::compatibility::std::SuppressStdOStreamOpTraits<TAppendable>::value )
ALIB_EXPORT std::ostream * operator<< (std::ostream *stream, const TAppendable &appendable)
 
ALIB_EXPORT ALIB_DLL std::wostream & operator<< (std::wostream &stream, const alib::NString &string)
 
ALIB_EXPORT std::wostream & operator<< (std::wostream &stream, const alib::WString &string)
 
template<typename TAppendable>
requires ( alib::strings::IsAppendable<TAppendable,alib::wchar,alib::lang::HeapAllocator> && !alib::strings::compatibility::std::SuppressStdOStreamOpTraits<TAppendable>::value )
ALIB_EXPORT std::wostream & operator<< (std::wostream &stream, const TAppendable &appendable)
 
ALIB_EXPORT std::wostream * operator<< (std::wostream *stream, const alib::NString &string)
 
ALIB_EXPORT std::wostream * operator<< (std::wostream *stream, const alib::WString &string)
 
template<typename TAppendable, typename TAllocator>
requires ( alib::strings::IsAppendable<TAppendable,alib::wchar,alib::lang::HeapAllocator> && !alib::strings::compatibility::std::SuppressStdOStreamOpTraits<TAppendable>::value )
ALIB_EXPORT std::wostream * operator<< (std::wostream *stream, const TAppendable &appendable)
 
ALIB_EXPORT std::basic_istream< wchar_t > & operator>> (std::basic_istream< wchar_t > &stream, alib::WAString &string)
 
ALIB_EXPORT std::basic_istream< wchar_t > * operator>> (std::basic_istream< wchar_t > *stream, alib::WAString &string)
 
ALIB_EXPORT std::istream & operator>> (std::istream &stream, alib::NAString &string)
 
ALIB_EXPORT std::istream * operator>> (std::istream *stream, alib::NAString &string)
 

Function Details:

◆ operator<<() [1/12]

ALIB_EXPORT std::ostream & alib::strings::compatibility::std::operator<< ( std::ostream & stream,
const alib::NString & string )
inline

Copies the contents of the given NString to into the std::ostream given as reference.

Note
Unlike this documentation indicates, the operator is defined in the global namespace.
Parameters
streamThe ostream object to write the given String into.
stringThe String to write into the given ostream.
Returns
The ostream to allow concatenated operations.

Definition at line 389 of file stdiostream.mpp.

Here is the call graph for this function:

◆ operator<<() [2/12]

ALIB_EXPORT ALIB_DLL std::ostream & alib::strings::compatibility::std::operator<< ( std::ostream & stream,
const alib::WString & string )

Copies the contents of the given WString to into the std::ostream given as reference.

Note
Unlike this documentation indicates, the operator is defined in the global namespace.
Parameters
streamThe ostream object to write the given String into.
stringThe String to write into the given ostream.
Returns
The ostream to allow concatenated operations.
Here is the call graph for this function:

◆ operator<<() [3/12]

template<typename TAppendable>
requires ( alib::strings::IsAppendable<TAppendable,alib::nchar,alib::lang::HeapAllocator> && !alib::strings::compatibility::std::SuppressStdOStreamOpTraits<TAppendable>::value )
ALIB_EXPORT std::ostream & alib::strings::compatibility::std::operator<< ( std::ostream & stream,
const TAppendable & appendable )

Copies the contents of the given appendable type the std::ostream given as reference.

Note
Unlike this documentation indicates, this operator is defined in the global namespace.
Template Parameters
TAppendableThe appendable type.
Parameters
streamThe std::ostream object to write the given String into.
appendableThe object whose contents is to be written into the given stream.
Returns
The ostream to allow concatenated operations.

Definition at line 625 of file stdiostream.mpp.

Here is the call graph for this function:

◆ operator<<() [4/12]

ALIB_EXPORT std::ostream * alib::strings::compatibility::std::operator<< ( std::ostream * stream,
const alib::NString & string )
inline

Copies the contents of the given NString to into the std::ostream given as pointer.

Note
Unlike this documentation indicates, the operator is defined in the global namespace.
Parameters
streamThe ostream object to write the given String into.
stringThe String to write into the given ostream.
Returns
The ostream to allow concatenated operations.

Definition at line 405 of file stdiostream.mpp.

Here is the call graph for this function:

◆ operator<<() [5/12]

ALIB_EXPORT std::ostream * alib::strings::compatibility::std::operator<< ( std::ostream * stream,
const alib::WString & string )
inline

Copies the contents of the given WString to into the std::ostream given as pointer.

Note
Unlike this documentation indicates, the operator is defined in the global namespace.
Parameters
streamThe ostream object to write the given String into.
stringThe String to write into the given ostream.
Returns
The ostream to allow concatenated operations.

Definition at line 431 of file stdiostream.mpp.

Here is the call graph for this function:

◆ operator<<() [6/12]

template<typename TAppendable>
requires ( alib::strings::IsAppendable<TAppendable,alib::nchar,alib::lang::HeapAllocator> && !alib::strings::compatibility::std::SuppressStdOStreamOpTraits<TAppendable>::value )
ALIB_EXPORT std::ostream * alib::strings::compatibility::std::operator<< ( std::ostream * stream,
const TAppendable & appendable )

Copies the contents of the given appendable type the std::ostream given as pointer.

Note
Unlike this documentation indicates, this operator is defined in the global namespace.
Template Parameters
TAppendableThe appendable type.
Parameters
streamThe std::ostream object to write the given String into.
appendableThe object whose contents is to be written into the given stream.
Returns
The ostream to allow concatenated operations.

Definition at line 650 of file stdiostream.mpp.

Here is the call graph for this function:

◆ operator<<() [7/12]

ALIB_EXPORT ALIB_DLL std::wostream & alib::strings::compatibility::std::operator<< ( std::wostream & stream,
const alib::NString & string )

Copies the contents of the given NString to into the std::wostream given as reference.

Note
This operator uses a local string buffer of 256 bytes size to convert the given narrow string to an string of wchar_t characters that the output stream accepts. In case that the given string is larger, a dynamic memory allocation has to be made.
In performance-critical code that writes larger string data, a custom conversion method, that for example reuses a buffer, may be appropriate.
Note
Unlike this documentation indicates, the operator is defined in the global namespace.
Parameters
streamThe ostream object to write the given String into.
stringThe String to write into the given ostream.
Returns
The ostream to allow concatenated operations.
Here is the call graph for this function:

◆ operator<<() [8/12]

ALIB_EXPORT std::wostream & alib::strings::compatibility::std::operator<< ( std::wostream & stream,
const alib::WString & string )
inline

Copies the contents of the given WString to into the std::wostream given as reference.

Note
Unlike this documentation indicates, the operator is defined in the global namespace.
Parameters
streamThe ostream object to write the given String into.
stringThe String to write into the given ostream.
Returns
The ostream to allow concatenated operations.

Definition at line 483 of file stdiostream.mpp.

Here is the call graph for this function:

◆ operator<<() [9/12]

template<typename TAppendable>
requires ( alib::strings::IsAppendable<TAppendable,alib::wchar,alib::lang::HeapAllocator> && !alib::strings::compatibility::std::SuppressStdOStreamOpTraits<TAppendable>::value )
ALIB_EXPORT std::wostream & alib::strings::compatibility::std::operator<< ( std::wostream & stream,
const TAppendable & appendable )

Copies the contents of the given appendable type the std::ostream given as reference.

Note
Unlike this documentation indicates, this operator is defined in the global namespace.
Template Parameters
TAppendableThe appendable type.
Parameters
streamThe std::ostream object to write the given String into.
appendableThe object whose contents is to be written into the given stream.
Returns
The ostream to allow concatenated operations.

Definition at line 672 of file stdiostream.mpp.

Here is the call graph for this function:

◆ operator<<() [10/12]

ALIB_EXPORT std::wostream * alib::strings::compatibility::std::operator<< ( std::wostream * stream,
const alib::NString & string )
inline

Copies the contents of the given NString to into the std::wostream given as pointer.

Note
Unlike this documentation indicates, the operator is defined in the global namespace.
See also
The notes on memory efficiency, documented with operator operator<<(std::wostream&,const NString&) which this operator uses inline.
Parameters
streamThe ostream object to write the given String into.
stringThe String to write into the given ostream.
Returns
The ostream to allow concatenated operations.

Definition at line 468 of file stdiostream.mpp.

Here is the call graph for this function:

◆ operator<<() [11/12]

ALIB_EXPORT std::wostream * alib::strings::compatibility::std::operator<< ( std::wostream * stream,
const alib::WString & string )
inline

Copies the contents of the given WString to into the std::wostream given as pointer.

Note
Unlike this documentation indicates, the operator is defined in the global namespace.
Parameters
streamThe ostream object to write the given String into.
stringThe String to write into the given ostream.
Returns
The ostream to allow concatenated operations.

Definition at line 507 of file stdiostream.mpp.

Here is the call graph for this function:

◆ operator<<() [12/12]

template<typename TAppendable, typename TAllocator>
requires ( alib::strings::IsAppendable<TAppendable,alib::wchar,alib::lang::HeapAllocator> && !alib::strings::compatibility::std::SuppressStdOStreamOpTraits<TAppendable>::value )
ALIB_EXPORT std::wostream * alib::strings::compatibility::std::operator<< ( std::wostream * stream,
const TAppendable & appendable )

Copies the contents of the given appendable type the std::ostream given as pointer.

Note
Unlike this documentation indicates, this operator is defined in the global namespace.
Template Parameters
TAppendableThe appendable type.
TAllocatorThe allocator type, as prototyped with Allocator.
Parameters
streamThe std::ostream object to write the given String into.
appendableThe object whose contents is to be written into the given stream.
Returns
The ostream to allow concatenated operations.

Definition at line 702 of file stdiostream.mpp.

Here is the call graph for this function:

◆ operator>>() [1/4]

ALIB_EXPORT std::basic_istream< wchar_t > & alib::strings::compatibility::std::operator>> ( std::basic_istream< wchar_t > & stream,
alib::WAString & string )
inline

Clears the given WAString and extracts data from the std::istream into it. The extractions ends with either the end of the std::istream or when reading a newline character.

Note
If code selection symbol ALIB_CHARACTERS_NATIVE_WCHAR evaluates to false, a local buffer is used to convert the string of wchar_t characters that the input stream provides. In case that the string read from the stream is larger, a dynamic memory allocation has to be made.
In performance-critical code that receives larger string data, a custom conversion method that, for example, reuses a buffer may be appropriate.
Note
Unlike this documentation indicates, the operator is defined in the global namespace.
Parameters
streamThe istream object to extract data from.
stringThe AString to receive data.
Returns
The ostream to allow concatenated operations.

Definition at line 569 of file stdiostream.mpp.

Here is the call graph for this function:

◆ operator>>() [2/4]

ALIB_EXPORT std::basic_istream< wchar_t > * alib::strings::compatibility::std::operator>> ( std::basic_istream< wchar_t > * stream,
alib::WAString & string )
inline

Clears the given WAString and extracts data from the std::istream into it. The extractions ends with either the end of the std::istream or when reading a newline character.

Note
Unlike this documentation indicates, the operator is defined in the global namespace.
See also
The notes on memory efficiency, documented with operator operator>>(std::basic_istream<wchar_t>&, WAString& ) which this operator uses inline.
Parameters
streamThe istream object to extract data from.
stringThe AString to receive data.
Returns
The ostream to allow concatenated operations.

Definition at line 599 of file stdiostream.mpp.

Here is the call graph for this function:

◆ operator>>() [3/4]

ALIB_EXPORT std::istream & alib::strings::compatibility::std::operator>> ( std::istream & stream,
alib::NAString & string )
inline

Clears the given NAString and extracts data from the std::istream into it. The extractions ends with either the end of the std::istream or when reading a newline character.

Note
Unlike this documentation indicates, the operator is defined in the global namespace.
Parameters
streamThe istream object to extract data from.
stringThe AString to receive data.
Returns
The ostream to allow concatenated operations.

Definition at line 523 of file stdiostream.mpp.

Here is the call graph for this function:

◆ operator>>() [4/4]

ALIB_EXPORT std::istream * alib::strings::compatibility::std::operator>> ( std::istream * stream,
alib::NAString & string )
inline

Clears the given NAString and extracts data from the std::istream into it. The extractions ends with either the end of the std::istream or when reading a newline character.

Note
Unlike this documentation indicates, the operator is defined in the global namespace.
Parameters
streamThe istream object to extract data from.
stringThe AString to receive data.
Returns
The ostream to allow concatenated operations.

Definition at line 540 of file stdiostream.mpp.

Here is the call graph for this function: