Arcane  4.1.12.0
User documentation
Loading...
Searching...
No Matches
Arcane::StringBuilder Class Reference
Core

Unicode character string constructor. More...

#include <arccore/base/StringBuilder.h>

Public Member Functions

 StringBuilder ()
 Creates a null string.
 StringBuilder (const char *str)
 Creates a string from str in local encoding.
 StringBuilder (const char *str, Integer len)
 Creates a string from str in local encoding.
 StringBuilder (const std::string &str)
 Creates a string from str in local encoding.
 StringBuilder (const UCharConstArrayView &ustr)
 Creates a string from str in Utf16 encoding.
 StringBuilder (const ByteConstArrayView &ustr)
 Creates a string from str in Utf8 encoding.
 StringBuilder (const StringBuilder &str_builder)
 Creates a string from str_builder.
 StringBuilder (StringImpl *impl)
 Creates a string from str in local encoding.
 StringBuilder (const String &str)
 Creates a string from str.
const StringBuilder & operator= (const String &str)
 Copies str into this instance.
const StringBuilder & operator= (const char *str)
 Copies str into this instance.
const StringBuilder & operator= (const StringBuilder &str)
 Copies str into this instance.
 ~StringBuilder ()
 Releases resources.
 operator String () const
 Returns the constructed character string.
String toString () const
 Returns the constructed character string.
StringBuilder & append (const String &str)
 Appends str.
StringBuilder clone () const
 Clones this string.
StringBuilder & replaceWhiteSpace ()
 Performs whitespace character normalization. All whitespace characters are replaced by space characters #x20, namely #xD (Carriage Return), #xA (Line Feed), and #x9 (Tabulation). This corresponds to the xs:replace attribute of XMLSchema 1.0.
StringBuilder & collapseWhiteSpace ()
 Performs whitespace character normalization. The behavior is identical to replaceWhiteSpace() plus:
StringBuilder & toUpper ()
 Converts all characters in the string to uppercase.
StringBuilder & toLower ()
 Converts all characters in the string to lowercase.
void operator+= (const char *str)
void operator+= (const String &str)
void operator+= (unsigned long v)
void operator+= (unsigned int v)
void operator+= (double v)
void operator+= (long double v)
void operator+= (int v)
void operator+= (char v)
void operator+= (long v)
void operator+= (unsigned long long v)
void operator+= (long long v)
void operator+= (const APReal &v)
void internalDump (std::ostream &ostr) const
 Displays internal class information.

Friends

bool operator== (const StringBuilder &a, const StringBuilder &b)
bool operator!= (const StringBuilder &a, const StringBuilder &b)

Detailed Description

Unicode character string constructor.

Allows efficient construction of a character string by concatenation.

\not_thread_safe

Definition at line 47 of file arccore/src/base/arccore/base/StringBuilder.h.

Constructor & Destructor Documentation

◆ StringBuilder() [1/9]

Arcane::StringBuilder::StringBuilder ( )
inline

Creates a null string.

Definition at line 52 of file arccore/src/base/arccore/base/StringBuilder.h.

Referenced by append(), clone(), collapseWhiteSpace(), operator=(), operator=(), operator=(), replaceWhiteSpace(), StringBuilder(), toLower(), and toUpper().

◆ StringBuilder() [2/9]

Arcane::StringBuilder::StringBuilder ( const char * str)

Creates a string from str in local encoding.

Definition at line 79 of file StringBuilder.cc.

◆ StringBuilder() [3/9]

Arcane::StringBuilder::StringBuilder ( const char * str,
Integer len )

Creates a string from str in local encoding.

Definition at line 69 of file StringBuilder.cc.

◆ StringBuilder() [4/9]

Arcane::StringBuilder::StringBuilder ( const std::string & str)

Creates a string from str in local encoding.

Definition at line 28 of file StringBuilder.cc.

◆ StringBuilder() [5/9]

Arcane::StringBuilder::StringBuilder ( const UCharConstArrayView & ustr)

Creates a string from str in Utf16 encoding.

Definition at line 38 of file StringBuilder.cc.

◆ StringBuilder() [6/9]

Arcane::StringBuilder::StringBuilder ( const ByteConstArrayView & ustr)

Creates a string from str in Utf8 encoding.

Definition at line 48 of file StringBuilder.cc.

◆ StringBuilder() [7/9]

Arcane::StringBuilder::StringBuilder ( const StringBuilder & str_builder)

Creates a string from str_builder.

Definition at line 109 of file StringBuilder.cc.

References StringBuilder().

◆ StringBuilder() [8/9]

Arcane::StringBuilder::StringBuilder ( StringImpl * impl)
explicit

Creates a string from str in local encoding.

Definition at line 58 of file StringBuilder.cc.

◆ StringBuilder() [9/9]

Arcane::StringBuilder::StringBuilder ( const String & str)

Creates a string from str.

Definition at line 97 of file StringBuilder.cc.

◆ ~StringBuilder()

Arcane::StringBuilder::~StringBuilder ( )

Releases resources.

Definition at line 123 of file StringBuilder.cc.

Member Function Documentation

◆ append()

StringBuilder & Arcane::StringBuilder::append ( const String & str)

Appends str.

Definition at line 234 of file StringBuilder.cc.

References Arcane::String::null(), and StringBuilder().

Referenced by Arcane::XmlNode::xpathFullName().

◆ clone()

StringBuilder Arcane::StringBuilder::clone ( ) const

Clones this string.

Definition at line 203 of file StringBuilder.cc.

References StringBuilder().

◆ collapseWhiteSpace()

StringBuilder & Arcane::StringBuilder::collapseWhiteSpace ( )

Performs whitespace character normalization. The behavior is identical to replaceWhiteSpace() plus:

  • replacement of all consecutive whitespaces with a single one.
  • removal of whitespaces at the beginning and end of the string. This corresponds to the xs:collapse attribute of XMLSchema 1.0

Definition at line 263 of file StringBuilder.cc.

References StringBuilder().

Referenced by Arcane::XmlElementContentChecker::check().

◆ internalDump()

void Arcane::StringBuilder::internalDump ( std::ostream & ostr) const

Displays internal class information.

This method is only useful for debugging Arccore

Definition at line 374 of file StringBuilder.cc.

◆ operator String()

Arcane::StringBuilder::operator String ( ) const

Returns the constructed character string.

Definition at line 225 of file StringBuilder.cc.

References toString().

◆ operator+=() [1/12]

void Arcane::StringBuilder::operator+= ( char v)

Definition at line 308 of file StringBuilder.cc.

◆ operator+=() [2/12]

void Arcane::StringBuilder::operator+= ( const APReal & v)

Definition at line 365 of file StringBuilder.cc.

◆ operator+=() [3/12]

void Arcane::StringBuilder::operator+= ( const char * str)

Definition at line 296 of file StringBuilder.cc.

◆ operator+=() [4/12]

void Arcane::StringBuilder::operator+= ( const String & str)

Definition at line 302 of file StringBuilder.cc.

◆ operator+=() [5/12]

void Arcane::StringBuilder::operator+= ( double v)

Definition at line 329 of file StringBuilder.cc.

◆ operator+=() [6/12]

void Arcane::StringBuilder::operator+= ( int v)

Definition at line 341 of file StringBuilder.cc.

◆ operator+=() [7/12]

void Arcane::StringBuilder::operator+= ( long double v)

Definition at line 335 of file StringBuilder.cc.

◆ operator+=() [8/12]

void Arcane::StringBuilder::operator+= ( long long v)

Definition at line 359 of file StringBuilder.cc.

◆ operator+=() [9/12]

void Arcane::StringBuilder::operator+= ( long v)

Definition at line 347 of file StringBuilder.cc.

◆ operator+=() [10/12]

void Arcane::StringBuilder::operator+= ( unsigned int v)

Definition at line 323 of file StringBuilder.cc.

◆ operator+=() [11/12]

void Arcane::StringBuilder::operator+= ( unsigned long long v)

Definition at line 353 of file StringBuilder.cc.

◆ operator+=() [12/12]

void Arcane::StringBuilder::operator+= ( unsigned long v)

Definition at line 317 of file StringBuilder.cc.

◆ operator=() [1/3]

const StringBuilder & Arcane::StringBuilder::operator= ( const char * str)

Copies str into this instance.

Definition at line 148 of file StringBuilder.cc.

References StringBuilder().

◆ operator=() [2/3]

const StringBuilder & Arcane::StringBuilder::operator= ( const String & str)

Copies str into this instance.

Definition at line 133 of file StringBuilder.cc.

References StringBuilder().

◆ operator=() [3/3]

const StringBuilder & Arcane::StringBuilder::operator= ( const StringBuilder & str)

Copies str into this instance.

Definition at line 162 of file StringBuilder.cc.

References StringBuilder().

◆ replaceWhiteSpace()

StringBuilder & Arcane::StringBuilder::replaceWhiteSpace ( )

Performs whitespace character normalization. All whitespace characters are replaced by space characters #x20, namely #xD (Carriage Return), #xA (Line Feed), and #x9 (Tabulation). This corresponds to the xs:replace attribute of XMLSchema 1.0.

Definition at line 252 of file StringBuilder.cc.

References StringBuilder().

◆ toLower()

StringBuilder & Arcane::StringBuilder::toLower ( )

Converts all characters in the string to lowercase.

Definition at line 285 of file StringBuilder.cc.

References StringBuilder().

◆ toString()

String Arcane::StringBuilder::toString ( ) const

Returns the constructed character string.

Definition at line 214 of file StringBuilder.cc.

Referenced by Arcane::CaseOptionMultiExtended::_search(), Arcane::CaseOptionMultiSimpleT< T >::_search(), Arcane::CaseOptionException::CaseOptionException(), Arcane::CaseOptionException::CaseOptionException(), Arcane::XmlElementContentChecker::check(), Arcane::Platform::getCompilerId(), operator String(), Arcane::operator<<(), and Arcane::Platform::timeToHourMinuteSecond().

◆ toUpper()

StringBuilder & Arcane::StringBuilder::toUpper ( )

Converts all characters in the string to uppercase.

Definition at line 274 of file StringBuilder.cc.

References StringBuilder().

◆ operator!=

bool operator!= ( const StringBuilder & a,
const StringBuilder & b )
friend

Definition at line 139 of file arccore/src/base/arccore/base/StringBuilder.h.

◆ operator==

bool operator== ( const StringBuilder & a,
const StringBuilder & b )
friend

Definition at line 402 of file StringBuilder.cc.

The documentation for this class was generated from the following files: