Chaîne de caractères unicode. Plus de détails...

#include </__w/arcaneframework.github.io/arcaneframework.github.io/framework/arccore/src/base/arccore/base/String.h>

Graphe de collaboration de Arccore::String:

Fonctions membres publiques
	String ()
	Crée une chaîne nulle.

	String (const char *str)
	Créé une chaîne à partir de str dans l'encodage UTF-8.

	String (char *str)
	Créé une chaîne à partir de str dans l'encodage UTF-8.

	String (const char *str, bool do_alloc)
	Créé une chaîne à partir de str dans l'encodage UTF-8.

	String (const char *str, Integer len)
	Créé une chaîne à partir de str dans l'encodage UTF-8.

	String (std::string_view str)
	Créé une chaîne à partir de str dans l'encodage UTF-8.

	String (StringView str)
	Créé une chaîne à partir de str dans l'encodage UTF-8.

	String (const std::string &str)
	Créé une chaîne à partir de str dans l'encodage UTF-8.

	String (const UCharConstArrayView &ustr)
	Créé une chaîne à partir de str dans l'encodage UTF-16.

	String (const Span< const Byte > &ustr)
	Créé une chaîne à partir de str dans l'encodage UTF-8.

	String (StringImpl *impl)
	Créé une chaîne à partir de str dans l'encodage UTF-8.

	String (const String &str)
	Créé une chaîne à partir de str.

	String (String &&str)
	Créé une chaîne à partir de str.

String &	operator= (const String &str)
	Copie str dans cette instance.

String &	operator= (String &&str)
	Copie str dans cette instance.

String &	operator= (StringView str)
	Copie str dans cette instance.

String &	operator= (const char *str)
	Référence str codé en UTF-8 dans cette instance.

String &	operator= (std::string_view str)
	Copie str codé en UTF-8 dans cette instance.

String &	operator= (const std::string &str)
	Copie str codé en UTF-8 dans cette instance.

	~String ()
	Libère les ressources.

	operator StringView () const
	Retourne une vue sur la chaîne actuelle.

ConstArrayView< UChar >	utf16 () const
	Retourne la conversion de l'instance dans l'encodage UTF-16.

ByteConstArrayView	utf8 () const
	Retourne la conversion de l'instance dans l'encodage UTF-8.

Span< const Byte >	bytes () const
	Retourne la conversion de l'instance dans l'encodage UTF-8.

const char *	localstr () const
	Retourne la conversion de l'instance dans l'encodage UTF-8.

std::string_view	toStdStringView () const
	Retourne une vue de la STL sur la chaîne actuelle.

StringView	view () const
	Retourne une vue sur la chaîne actuelle.

String	clone () const
	Clone cette chaîne.

String	upper () const
	Transforme tous les caractères de la chaîne en majuscules.

String	lower () const
	Transforme tous les caractères de la chaîne en minuscules.

bool	null () const
	Retourne true si la chaîne est nulle.

Integer	len () const
	Retourne la longueur de la chaîne en 32 bits.

Int64	length () const
	Retourne la longueur de la chaîne.

bool	empty () const
	Vrai si la chaîne est vide (nulle ou "")

Int32	hashCode () const
	Calcule une valeur de hashage pour cette chaîne de caractères.

void	writeBytes (std::ostream &o) const
	Écrit la chaîne au format UTF-8 sur le flot o.

String	operator+ (const char *str) const
	Retourne la concaténation de cette chaîne avec la chaîne str encodée en UTF-8.

String	operator+ (std::string_view str) const
	Retourne la concaténation de cette chaîne avec la chaîne str encodée en UTF-8.

String	operator+ (const std::string &str) const
	Retourne la concaténation de cette chaîne avec la chaîne str encodée en UTF-8.

String	operator+ (const String &str) const
	Retourne la concaténation de cette chaîne avec la chaîne str.

String	operator+ (unsigned long v) const

String	operator+ (unsigned int v) const

String	operator+ (double v) const

String	operator+ (long double v) const

String	operator+ (int v) const

String	operator+ (long v) const

String	operator+ (unsigned long long v) const

String	operator+ (long long v) const

String	operator+ (const APReal &v) const

bool	contains (const String &s) const
	Indique si la chaîne contient s.

bool	startsWith (const String &s) const
	Indique si la chaîne commence par les caractères de s.

bool	endsWith (const String &s) const
	Indique si la chaîne se termine par les caractères de s.

String	substring (Int64 pos) const
	Sous-chaîne commençant à la position pos.

String	substring (Int64 pos, Int64 len) const
	Sous-chaîne commençant à la position pos et de longueur len.

template<typename StringContainer>
void	split (StringContainer &str_array, char c) const
	Découpe la chaîne suivant le caractère c.

void	internalDump (std::ostream &ostr) const
	Affiche les infos internes de la classe.

Fonctions membres publiques statiques
static String	fromUtf8 (Span< const Byte > bytes)

static String	replaceWhiteSpace (const String &rhs)
	Effectue une normalisation des caractères espaces.

static String	collapseWhiteSpace (const String &rhs)
	Effectue une normalisation des caractères espaces.

static String	fromNumber (unsigned long v)

static String	fromNumber (unsigned int v)

static String	fromNumber (double v)

static String	fromNumber (double v, Integer nb_digit_after_point)

static String	fromNumber (long double v)

static String	fromNumber (int v)

static String	fromNumber (long v)

static String	fromNumber (unsigned long long v)

static String	fromNumber (long long v)

static String	fromNumber (const APReal &v)

static String	format (const String &str)

static String	format (const String &str, const StringFormatterArg &arg1)

static String	format (const String &str, const StringFormatterArg &arg1, const StringFormatterArg &arg2)

static String	format (const String &str, const StringFormatterArg &arg1, const StringFormatterArg &arg2, const StringFormatterArg &arg3)

static String	format (const String &str, const StringFormatterArg &arg1, const StringFormatterArg &arg2, const StringFormatterArg &arg3, const StringFormatterArg &arg4)

static String	format (const String &str, const StringFormatterArg &arg1, const StringFormatterArg &arg2, const StringFormatterArg &arg3, const StringFormatterArg &arg4, const StringFormatterArg &arg5)

static String	format (const String &str, const StringFormatterArg &arg1, const StringFormatterArg &arg2, const StringFormatterArg &arg3, const StringFormatterArg &arg4, const StringFormatterArg &arg5, const StringFormatterArg &arg6)

static String	format (const String &str, const StringFormatterArg &arg1, const StringFormatterArg &arg2, const StringFormatterArg &arg3, const StringFormatterArg &arg4, const StringFormatterArg &arg5, const StringFormatterArg &arg6, const StringFormatterArg &arg7)

static String	format (const String &str, const StringFormatterArg &arg1, const StringFormatterArg &arg2, const StringFormatterArg &arg3, const StringFormatterArg &arg4, const StringFormatterArg &arg5, const StringFormatterArg &arg6, const StringFormatterArg &arg7, const StringFormatterArg &arg8)

static String	format (const String &str, const StringFormatterArg &arg1, const StringFormatterArg &arg2, const StringFormatterArg &arg3, const StringFormatterArg &arg4, const StringFormatterArg &arg5, const StringFormatterArg &arg6, const StringFormatterArg &arg7, const StringFormatterArg &arg8, const StringFormatterArg &arg9)

static String	concat (const StringFormatterArg &arg1)

static String	concat (const StringFormatterArg &arg1, const StringFormatterArg &arg2)

static String	concat (const StringFormatterArg &arg1, const StringFormatterArg &arg2, const StringFormatterArg &arg3)

static String	concat (const StringFormatterArg &arg1, const StringFormatterArg &arg2, const StringFormatterArg &arg3, const StringFormatterArg &arg4)

static String	plural (const Integer n, const String &str, const bool with_number=true)
	Forme standard du pluriel par ajout d'un 's'.

static String	plural (const Integer n, const String &str, const String &str2, const bool with_number=true)
	Forme particulière du pluriel par variante.

static String	join (String delim, ConstArrayView< String > strs)

Fonctions membres privées
void	_checkClone () const

bool	isLess (const String &s) const

String &	_append (const String &str)

std::string_view	_viewFromConstChar () const

void	_removeReference ()

ConstArrayView< UChar >	_internalUtf16BE () const

void	_resetFields ()

void	_copyFields (const String &str)

void	_removeReferenceIfNeeded ()
	Supprime la référence à l'implémentation si elle n'est pas nulle.

void	_removeImplReference ()
	Supprime la référence à l'implémentation.

Attributs privés
StringImpl *	m_p = nullptr
	Implémentation de la classe.

const char *	m_const_ptr = nullptr

Int64	m_const_ptr_size = 0
	Longueur de la chaîne si constante (-1 sinon)

Amis
class	StringBuilder

class	StringUtilsImpl

ARCCORE_BASE_EXPORT bool	operator< (const String &a, const String &b)

ARCCORE_BASE_EXPORT bool	operator< (const String &a, const String &b)

ARCCORE_BASE_EXPORT bool	operator== (const String &a, const String &b)
	Compare deux chaînes unicode.

ARCCORE_BASE_EXPORT bool	operator== (const char *a, const String &b)
	Compare deux chaînes unicode.

ARCCORE_BASE_EXPORT bool	operator== (const String &a, const char *b)
	Compare deux chaînes unicode.

bool	operator!= (const String &a, const String &b)
	Compare deux chaînes unicode.

bool	operator!= (const char *a, const String &b)
	Compare deux chaînes unicode.

bool	operator!= (const String &a, const char *b)
	Compare deux chaînes unicode.

ARCCORE_BASE_EXPORT std::ostream &	operator<< (std::ostream &o, const String &str)
	Opérateur d'écriture d'une String.

ARCCORE_BASE_EXPORT std::istream &	operator>> (std::istream &o, String &str)
	Opérateur de lecture d'une String.

ARCCORE_BASE_EXPORT String	operator+ (const char *a, const String &b)
	Ajoute deux chaînes.

Description détaillée

Chaîne de caractères unicode.

Cette classe permet de gérer une chaîne de caractères soit avec l'encodage UTF-8 soit avec l'encodage UTF-16. A noter que l'encodage UTF-16 est obsolète et sera supprimé dans une version ultérieure lorsque le C++20 sera disponible.

Toutes les méthodes utilisant des const char* en arguments supposent que l'encodage utilisé est en UTF-8.

Les instances de cette classe sont immutables.

Cette classe est similaire à std::string mais avec les différences suivantes:

la classe String utilise l'encodage UTF-8 alors que pour std::string l'encodage est indéfini.
contrairement à std::string, il n'est pas possible actuellement de conserver des caractères nuls à l'intérieur d'une String.
pour String, il y a une distinction entre la chaîne nulle et la chaîne vide. Le constructeur String::String() créé une chaîne nulle alors que String::String("") créé une chaîne vide. Si la chaîne est nulle, les appels à view() ou toStdStringView() retourne une chaîne vide.

Lorsque le C++20 sera disponible, la classe String correspondra au type std::optional<std::u8string>.

Pour des raisons de performance, pour construire par morceaux une chaîne de caractères, il est préférable d'utiliser la classe 'StringBuilder'.

Définition à la ligne 69 du fichier arccore/src/base/arccore/base/String.h.

Documentation des constructeurs et destructeur

◆ String() [1/13]

Arcane::String::String ( )

inline

Crée une chaîne nulle.

Définition à la ligne 80 du fichier arccore/src/base/arccore/base/String.h.

◆ String() [2/13]

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

inline

Créé une chaîne à partir de str dans l'encodage UTF-8.

Avertissement: Attention, la chaine est supposée constante sa validité infinie (i.e il s'agit d'une chaîne constante à la compilation. Si la chaîne passée en argument peut être désallouée, il faut utiliser String(std::string_view) à la place.

Définition à la ligne 89 du fichier arccore/src/base/arccore/base/String.h.

◆ String() [3/13]

Arcane::String::String ( char * str )

Créé une chaîne à partir de str dans l'encodage UTF-8.

Définition à la ligne 125 du fichier String.cc.

◆ String() [4/13]

Arcane::String::String	(	const char *	str,
		bool	do_alloc )

Créé une chaîne à partir de str dans l'encodage UTF-8.

Définition à la ligne 136 du fichier String.cc.

◆ String() [5/13]

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

Créé une chaîne à partir de str dans l'encodage UTF-8.

Définition à la ligne 114 du fichier String.cc.

◆ String() [6/13]

Arcane::String::String ( std::string_view str )

Créé une chaîne à partir de str dans l'encodage UTF-8.

Définition à la ligne 57 du fichier String.cc.

◆ String() [7/13]

Arcane::String::String ( StringView str )

Créé une chaîne à partir de str dans l'encodage UTF-8.

Définition à la ligne 68 du fichier String.cc.

◆ String() [8/13]

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

Créé une chaîne à partir de str dans l'encodage UTF-8.

Définition à la ligne 46 du fichier String.cc.

◆ String() [9/13]

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

Créé une chaîne à partir de str dans l'encodage UTF-16.

Définition à la ligne 80 du fichier String.cc.

◆ String() [10/13]

Arcane::String::String ( const Span< const Byte > & ustr )

Créé une chaîne à partir de str dans l'encodage UTF-8.

Définition à la ligne 91 du fichier String.cc.

◆ String() [11/13]

Arcane::String::String ( StringImpl * impl )

explicit

Créé une chaîne à partir de str dans l'encodage UTF-8.

Créé une chaîne à partir de str dans l'encodage UTF-8

Définition à la ligne 102 du fichier String.cc.

◆ String() [12/13]

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

Créé une chaîne à partir de str.

Définition à la ligne 156 du fichier String.cc.

◆ String() [13/13]

Arcane::String::String ( String && str )

inline

Créé une chaîne à partir de str.

Définition à la ligne 120 du fichier arccore/src/base/arccore/base/String.h.

◆ ~String()

Arcane::String::~String ( )

inline

Libère les ressources.

Définition à la ligne 156 du fichier arccore/src/base/arccore/base/String.h.

Documentation des fonctions membres

◆ _append()

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

private

Définition à la ligne 423 du fichier String.cc.

◆ _checkClone()

void Arcane::String::_checkClone ( ) const

private

Définition à la ligne 388 du fichier String.cc.

◆ _copyFields()

void Arcane::String::_copyFields ( const String & str )

inlineprivate

Définition à la ligne 545 du fichier arccore/src/base/arccore/base/String.h.

◆ _internalUtf16BE()

ConstArrayView< UChar > Arcane::String::_internalUtf16BE ( ) const

private

Définition à la ligne 249 du fichier String.cc.

◆ _removeImplReference()

void Arcane::String::_removeImplReference ( )

private

Supprime la référence à l'implémentation.

Précondition: m_p != nullptr

Définition à la ligne 240 du fichier String.cc.

◆ _removeReferenceIfNeeded()

void Arcane::String::_removeReferenceIfNeeded ( )

inlineprivate

Supprime la référence à l'implémentation si elle n'est pas nulle.

Définition à la ligne 555 du fichier arccore/src/base/arccore/base/String.h.

◆ _resetFields()

void Arcane::String::_resetFields ( )

inlineprivate

Définition à la ligne 539 du fichier arccore/src/base/arccore/base/String.h.

◆ _viewFromConstChar()

std::string_view Arcane::String::_viewFromConstChar ( ) const

inlineprivate

Définition à la ligne 533 du fichier arccore/src/base/arccore/base/String.h.

◆ bytes()

Span< const Byte > Arcane::String::bytes ( ) const

Retourne la conversion de l'instance dans l'encodage UTF-8.

bytes().size() correspond à la longueur de la chaîne de caractères mais la vue retournée contient toujours un '\0' terminal.

Avertissement: L'instance reste propriétaire de la valeur retournée et cette valeur est invalidée par toute modification de cette instance.

Définition à la ligne 291 du fichier String.cc.

◆ clone()

String Arcane::String::clone ( ) const

Clone cette chaîne.

Définition à la ligne 412 du fichier String.cc.

◆ collapseWhiteSpace()

String Arcane::String::collapseWhiteSpace ( const String & rhs )

static

Effectue une normalisation des caractères espaces.

Le comportement est identique à replaceWhiteSpace() avec en plus:

remplacement de tous les blancs consécutifs par un seul.
suppression des blancs en début et fin de chaîne. Cela correspond à l'attribut xs:collapse de XMLSchema 1.0

Définition à la ligne 452 du fichier String.cc.

◆ concat() [1/4]

String Arcane::String::concat ( const StringFormatterArg & arg1 )

static

Définition à la ligne 1007 du fichier String.cc.

◆ concat() [2/4]

String Arcane::String::concat	(	const StringFormatterArg &	arg1,
		const StringFormatterArg &	arg2 )

static

Définition à la ligne 1013 du fichier String.cc.

◆ concat() [3/4]

String Arcane::String::concat	(	const StringFormatterArg &	arg1,
		const StringFormatterArg &	arg2,
		const StringFormatterArg &	arg3 )

static

Définition à la ligne 1020 du fichier String.cc.

◆ concat() [4/4]

String Arcane::String::concat	(	const StringFormatterArg &	arg1,
		const StringFormatterArg &	arg2,
		const StringFormatterArg &	arg3,
		const StringFormatterArg &	arg4 )

static

Définition à la ligne 1028 du fichier String.cc.

◆ contains()

bool Arcane::String::contains ( const String & s ) const

Indique si la chaîne contient s.

Définition à la ligne 1067 du fichier String.cc.

◆ empty()

bool Arcane::String::empty ( ) const

Vrai si la chaîne est vide (nulle ou "")

Définition à la ligne 315 du fichier String.cc.

◆ endsWith()

bool Arcane::String::endsWith ( const String & s ) const

Indique si la chaîne se termine par les caractères de s.

Définition à la ligne 1083 du fichier String.cc.

◆ format() [1/10]

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

static

Définition à la ligne 827 du fichier String.cc.

◆ format() [2/10]

String Arcane::String::format	(	const String &	str,
		const StringFormatterArg &	arg1 )

static

Définition à la ligne 836 du fichier String.cc.

◆ format() [3/10]

String Arcane::String::format	(	const String &	str,
		const StringFormatterArg &	arg1,
		const StringFormatterArg &	arg2 )

static

Définition à la ligne 847 du fichier String.cc.

◆ format() [4/10]

String Arcane::String::format	(	const String &	str,
		const StringFormatterArg &	arg1,
		const StringFormatterArg &	arg2,
		const StringFormatterArg &	arg3 )

static

Définition à la ligne 860 du fichier String.cc.

◆ format() [5/10]

String Arcane::String::format	(	const String &	str,
		const StringFormatterArg &	arg1,
		const StringFormatterArg &	arg2,
		const StringFormatterArg &	arg3,
		const StringFormatterArg &	arg4 )

static

Définition à la ligne 875 du fichier String.cc.

◆ format() [6/10]

String Arcane::String::format	(	const String &	str,
		const StringFormatterArg &	arg1,
		const StringFormatterArg &	arg2,
		const StringFormatterArg &	arg3,
		const StringFormatterArg &	arg4,
		const StringFormatterArg &	arg5 )

static

Définition à la ligne 892 du fichier String.cc.

◆ format() [7/10]

String Arcane::String::format	(	const String &	str,
		const StringFormatterArg &	arg1,
		const StringFormatterArg &	arg2,
		const StringFormatterArg &	arg3,
		const StringFormatterArg &	arg4,
		const StringFormatterArg &	arg5,
		const StringFormatterArg &	arg6 )

static

Définition à la ligne 911 du fichier String.cc.

◆ format() [8/10]

String Arcane::String::format	(	const String &	str,
		const StringFormatterArg &	arg1,
		const StringFormatterArg &	arg2,
		const StringFormatterArg &	arg3,
		const StringFormatterArg &	arg4,
		const StringFormatterArg &	arg5,
		const StringFormatterArg &	arg6,
		const StringFormatterArg &	arg7 )

static

Définition à la ligne 932 du fichier String.cc.

◆ format() [9/10]

String Arcane::String::format	(	const String &	str,
		const StringFormatterArg &	arg1,
		const StringFormatterArg &	arg2,
		const StringFormatterArg &	arg3,
		const StringFormatterArg &	arg4,
		const StringFormatterArg &	arg5,
		const StringFormatterArg &	arg6,
		const StringFormatterArg &	arg7,
		const StringFormatterArg &	arg8 )

static

Définition à la ligne 955 du fichier String.cc.

◆ format() [10/10]

String Arcane::String::format	(	const String &	str,
		const StringFormatterArg &	arg1,
		const StringFormatterArg &	arg2,
		const StringFormatterArg &	arg3,
		const StringFormatterArg &	arg4,
		const StringFormatterArg &	arg5,
		const StringFormatterArg &	arg6,
		const StringFormatterArg &	arg7,
		const StringFormatterArg &	arg8,
		const StringFormatterArg &	arg9 )

static

Définition à la ligne 980 du fichier String.cc.

◆ fromNumber() [1/10]

String Arcane::String::fromNumber ( const APReal & v )

static

Définition à la ligne 572 du fichier String.cc.

◆ fromNumber() [2/10]

String Arcane::String::fromNumber ( double v )

static

Définition à la ligne 536 du fichier String.cc.

◆ fromNumber() [3/10]

String Arcane::String::fromNumber	(	double	v,
		Integer	nb_digit_after_point )

static

Définition à la ligne 578 du fichier String.cc.

◆ fromNumber() [4/10]

String Arcane::String::fromNumber ( int v )

static

Définition à la ligne 548 du fichier String.cc.

◆ fromNumber() [5/10]

String Arcane::String::fromNumber ( long double v )

static

Définition à la ligne 542 du fichier String.cc.

◆ fromNumber() [6/10]

String Arcane::String::fromNumber ( long long v )

static

Définition à la ligne 566 du fichier String.cc.

◆ fromNumber() [7/10]

String Arcane::String::fromNumber ( long v )

static

Définition à la ligne 554 du fichier String.cc.

◆ fromNumber() [8/10]

String Arcane::String::fromNumber ( unsigned int v )

static

Définition à la ligne 530 du fichier String.cc.

◆ fromNumber() [9/10]

String Arcane::String::fromNumber ( unsigned long long v )

static

Définition à la ligne 560 du fichier String.cc.

◆ fromNumber() [10/10]

String Arcane::String::fromNumber ( unsigned long v )

static

Définition à la ligne 524 du fichier String.cc.

◆ fromUtf8()

String Arcane::String::fromUtf8 ( Span< const Byte > bytes )

static

Définition à la ligne 710 du fichier String.cc.

◆ hashCode()

Int32 Arcane::String::hashCode ( ) const

Calcule une valeur de hashage pour cette chaîne de caractères.

Définition à la ligne 733 du fichier String.cc.

◆ internalDump()

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

Affiche les infos internes de la classe.

Cette méthode n'est utile que pour débugger Arccore

Définition à la ligne 719 du fichier String.cc.

◆ isLess()

bool Arcane::String::isLess ( const String & s ) const

private

Définition à la ligne 674 du fichier String.cc.

◆ join()

String Arcane::String::join	(	String	delim,
		ConstArrayView< String >	strs )

static

Définition à la ligne 1137 du fichier String.cc.

◆ len()

Integer Arcane::String::len ( ) const

Retourne la longueur de la chaîne en 32 bits.

Définition à la ligne 328 du fichier String.cc.

◆ length()

Int64 Arcane::String::length ( ) const

Retourne la longueur de la chaîne.

Définition à la ligne 338 du fichier String.cc.

◆ localstr()

const char * Arcane::String::localstr ( ) const

Retourne la conversion de l'instance dans l'encodage UTF-8.

Si null() est vrai, retourne la chaîne vide. Sinon, cette méthode est équivalent à appeler bytes().data(). Il y a toujours un '\0' terminal à la fin de la chaîne retournée.

Avertissement: L'instance reste propriétaire de la valeur retournée et cette valeur est invalidée par toute modification de cette instance.

Définition à la ligne 227 du fichier String.cc.

◆ lower()

String Arcane::String::lower ( ) const

Transforme tous les caractères de la chaîne en minuscules.

Définition à la ligne 478 du fichier String.cc.

◆ null()

bool Arcane::String::null ( ) const

Retourne true si la chaîne est nulle.

Définition à la ligne 304 du fichier String.cc.

◆ operator StringView()

Arcane::String::operator StringView ( ) const

Retourne une vue sur la chaîne actuelle.

L'encodage utilisé est UTF-8.

Avertissement: L'instance reste propriétaire de la valeur retournée et cette valeur est invalidée par toute modification de cette instance. La vue retournée ne doit pas être conservée.

Définition à la ligne 380 du fichier String.cc.

◆ operator+() [1/13]

String Arcane::String::operator+ ( const APReal & v ) const

Définition à la ligne 664 du fichier String.cc.

◆ operator+() [2/13]

String Arcane::String::operator+ ( const char * str ) const

inline

Retourne la concaténation de cette chaîne avec la chaîne str encodée en UTF-8.

Définition à la ligne 372 du fichier arccore/src/base/arccore/base/String.h.

◆ operator+() [3/13]

String Arcane::String::operator+ ( const std::string & str ) const

Retourne la concaténation de cette chaîne avec la chaîne str encodée en UTF-8.

Définition à la ligne 502 du fichier String.cc.

◆ operator+() [4/13]

String Arcane::String::operator+ ( const String & str ) const

Retourne la concaténation de cette chaîne avec la chaîne str.

Définition à la ligne 514 du fichier String.cc.

◆ operator+() [5/13]

String Arcane::String::operator+ ( double v ) const

Définition à la ligne 622 du fichier String.cc.

◆ operator+() [6/13]

String Arcane::String::operator+ ( int v ) const

Définition à la ligne 636 du fichier String.cc.

◆ operator+() [7/13]

String Arcane::String::operator+ ( long double v ) const

Définition à la ligne 629 du fichier String.cc.

◆ operator+() [8/13]

String Arcane::String::operator+ ( long long v ) const

Définition à la ligne 657 du fichier String.cc.

◆ operator+() [9/13]

String Arcane::String::operator+ ( long v ) const

Définition à la ligne 643 du fichier String.cc.

◆ operator+() [10/13]

String Arcane::String::operator+ ( std::string_view str ) const

Retourne la concaténation de cette chaîne avec la chaîne str encodée en UTF-8.

Définition à la ligne 490 du fichier String.cc.

◆ operator+() [11/13]

String Arcane::String::operator+ ( unsigned int v ) const

Définition à la ligne 615 du fichier String.cc.

◆ operator+() [12/13]

String Arcane::String::operator+ ( unsigned long long v ) const

Définition à la ligne 650 du fichier String.cc.

◆ operator+() [13/13]

String Arcane::String::operator+ ( unsigned long v ) const

Définition à la ligne 608 du fichier String.cc.

◆ operator=() [1/6]

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

inline

Référence str codé en UTF-8 dans cette instance.

Avertissement: Attention, la chaine est supposée constante sa validité infinie (i.e il s'agit d'une chaîne constante à la compilation. Si la chaîne passée en argument peut être désallouée, il faut utiliser String::operator=(std::string_view) à la place.

Définition à la ligne 140 du fichier arccore/src/base/arccore/base/String.h.

◆ operator=() [2/6]

String & Arcane::String::operator= ( const std::string & str )

Copie str codé en UTF-8 dans cette instance.

Définition à la ligne 215 du fichier String.cc.

◆ operator=() [3/6]

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

Copie str dans cette instance.

Définition à la ligne 169 du fichier String.cc.

◆ operator=() [4/6]

String & Arcane::String::operator= ( std::string_view str )

Copie str codé en UTF-8 dans cette instance.

Définition à la ligne 206 du fichier String.cc.

◆ operator=() [5/6]

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

Copie str dans cette instance.

Définition à la ligne 182 du fichier String.cc.

◆ operator=() [6/6]

String & Arcane::String::operator= ( StringView str )

Copie str dans cette instance.

Définition à la ligne 197 du fichier String.cc.

◆ plural() [1/2]

String Arcane::String::plural	(	const Integer	n,
		const String &	str,
		const bool	with_number = true )

static

Forme standard du pluriel par ajout d'un 's'.

Définition à la ligne 1040 du fichier String.cc.

◆ plural() [2/2]

String Arcane::String::plural	(	const Integer	n,
		const String &	str,
		const String &	str2,
		const bool	with_number = true )

static

Forme particulière du pluriel par variante.

Définition à la ligne 1055 du fichier String.cc.

◆ replaceWhiteSpace()

String Arcane::String::replaceWhiteSpace ( const String & rhs )

static

Effectue une normalisation des caractères espaces.

Tous les caractères espaces sont remplacés par des blancs espaces #x20, à savoir #xD (Carriage Return), #xA (Line Feed) et #x9 (Tabulation). Cela correspond à l'attribut xs:replace de XMLSchema 1.0

Définition à la ligne 440 du fichier String.cc.

◆ split()

template<typename StringContainer>

void Arcane::String::split	(	StringContainer &	str_array,
		char	c ) const

inline

Découpe la chaîne suivant le caractère c.

Définition à la ligne 488 du fichier arccore/src/base/arccore/base/String.h.

◆ startsWith()

bool Arcane::String::startsWith ( const String & s ) const

Indique si la chaîne commence par les caractères de s.

Définition à la ligne 1099 du fichier String.cc.

◆ substring() [1/2]

String Arcane::String::substring ( Int64 pos ) const

Sous-chaîne commençant à la position pos.

Définition à la ligne 1114 du fichier String.cc.

◆ substring() [2/2]

String Arcane::String::substring	(	Int64	pos,
		Int64	len ) const

Sous-chaîne commençant à la position pos et de longueur len.

Définition à la ligne 1123 du fichier String.cc.

◆ toStdStringView()

std::string_view Arcane::String::toStdStringView ( ) const

Retourne une vue de la STL sur la chaîne actuelle.

L'encodage utilisé est UTF-8.

Avertissement: L'instance reste propriétaire de la valeur retournée et cette valeur est invalidée par toute modification de cette instance. La vue retournée ne doit pas être conservée.

Définition à la ligne 348 du fichier String.cc.

◆ upper()

String Arcane::String::upper ( ) const

Transforme tous les caractères de la chaîne en majuscules.

Définition à la ligne 466 du fichier String.cc.

◆ utf16()

ConstArrayView< UChar > Arcane::String::utf16 ( ) const

Retourne la conversion de l'instance dans l'encodage UTF-16.

Le tableau retourné contient toujours un zéro terminal si la chaîne n'est par nulle. Par conséquent, la taille de toute chaîne non nulle est celle du tableau moins 1.

Avertissement: L'instance reste propriétaire de la valeur retournée et cette valeur est invalidée par toute modification de cette instance.

Obsolète: Il faut utiliser StringUtils::asUtf16BE() à la place. A noter que la fonction StringUtils::asUtf16BE() ne contient pas de 0x00 terminal.

Définition à la ligne 266 du fichier String.cc.

◆ utf8()

ByteConstArrayView Arcane::String::utf8 ( ) const

Retourne la conversion de l'instance dans l'encodage UTF-8.

Le tableau retourné contient toujours un zéro terminal si la chaîne n'est par nulle. Par conséquent, la taille de toute chaîne non nulle est celle du tableau moins 1.

Avertissement: L'instance reste propriétaire de la valeur retournée et cette valeur est invalidée par toute modification de cette instance.

Définition à la ligne 275 du fichier String.cc.

◆ view()

StringView Arcane::String::view ( ) const

Retourne une vue sur la chaîne actuelle.

L'encodage utilisé est UTF-8.

Avertissement: L'instance reste propriétaire de la valeur retournée et cette valeur est invalidée par toute modification de cette instance. La vue retournée ne doit pas être conservée.

Définition à la ligne 367 du fichier String.cc.

◆ writeBytes()

void Arcane::String::writeBytes ( std::ostream & o ) const

Écrit la chaîne au format UTF-8 sur le flot o.

Définition à la ligne 1236 du fichier String.cc.

Documentation des fonctions amies et associées

◆ operator!= [1/3]

bool operator!=	(	const char *	a,
		const String &	b )

friend

Compare deux chaînes unicode.

Valeurs retournées

true	si elles sont différentes,
false	si elles sont égales.

Définition à la ligne 342 du fichier arccore/src/base/arccore/base/String.h.

◆ operator!= [2/3]

bool operator!=	(	const String &	a,
		const char *	b )

friend

Compare deux chaînes unicode.

Valeurs retournées

true	si elles sont différentes,
false	si elles sont égales.

Définition à la ligne 359 du fichier arccore/src/base/arccore/base/String.h.

◆ operator!= [3/3]

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

friend

Compare deux chaînes unicode.

Valeurs retournées

true	si elles sont différentes,
false	si elles sont égales. \relate String

Définition à la ligne 320 du fichier arccore/src/base/arccore/base/String.h.

◆ operator+

ARCCORE_BASE_EXPORT String operator+	(	const char *	a,
		const String &	b )

friend

Ajoute deux chaînes.

Définition à la ligne 1209 du fichier String.cc.

◆ operator< [1/2]

ARCCORE_BASE_EXPORT bool operator<	(	const String &	a,
		const String &	b )

friend

Définition à la ligne 1194 du fichier String.cc.

◆ operator< [2/2]

ARCCORE_BASE_EXPORT bool operator<	(	const String &	a,
		const String &	b )

friend

Définition à la ligne 1194 du fichier String.cc.

◆ operator<<

ARCCORE_BASE_EXPORT std::ostream & operator<<	(	std::ostream &	o,
		const String &	str )

friend

Opérateur d'écriture d'une String.

Définition à la ligne 1221 du fichier String.cc.

◆ operator== [1/3]

ARCCORE_BASE_EXPORT bool operator==	(	const char *	a,
		const String &	b )

friend

Compare deux chaînes unicode.

Valeurs retournées

true	si elles sont égales,
false	sinon.

Définition à la ligne 1189 du fichier String.cc.

◆ operator== [2/3]

ARCCORE_BASE_EXPORT bool operator==	(	const String &	a,
		const char *	b )

friend

Compare deux chaînes unicode.

Valeurs retournées

true	si elles sont égales,
false	sinon.

Définition à la ligne 1182 du fichier String.cc.

◆ operator== [3/3]

ARCCORE_BASE_EXPORT bool operator==	(	const String &	a,
		const String &	b )

friend

Compare deux chaînes unicode.

Valeurs retournées

true	si elles sont égales,
false	sinon. \relate String

Définition à la ligne 1153 du fichier String.cc.

◆ operator>>

ARCCORE_BASE_EXPORT std::istream & operator>>	(	std::istream &	o,
		String &	str )

friend

Opérateur de lecture d'une String.

Définition à la ligne 1248 du fichier String.cc.

◆ StringBuilder

friend class StringBuilder

friend

Définition à la ligne 74 du fichier arccore/src/base/arccore/base/String.h.

◆ StringUtilsImpl

friend class StringUtilsImpl

friend

Définition à la ligne 75 du fichier arccore/src/base/arccore/base/String.h.

Documentation des données membres

◆ m_const_ptr

const char* Arcane::String::m_const_ptr = nullptr

mutableprivate

Définition à la ligne 526 du fichier arccore/src/base/arccore/base/String.h.

◆ m_const_ptr_size

Int64 Arcane::String::m_const_ptr_size = 0

mutableprivate

Longueur de la chaîne si constante (-1 sinon)

Définition à la ligne 527 du fichier arccore/src/base/arccore/base/String.h.

◆ m_p

StringImpl* Arcane::String::m_p = nullptr

mutableprivate

Implémentation de la classe.

Définition à la ligne 525 du fichier arccore/src/base/arccore/base/String.h.

La documentation de cette classe a été générée à partir des fichiers suivants :

Fonctions membres publiques

Fonctions membres publiques statiques

Fonctions membres privées

Attributs privés

Amis

Description détaillée

Documentation des constructeurs et destructeur

◆ String() [1/13]

◆ String() [2/13]

◆ String() [3/13]

◆ String() [4/13]

◆ String() [5/13]

◆ String() [6/13]

◆ String() [7/13]

◆ String() [8/13]

◆ String() [9/13]

◆ String() [10/13]

◆ String() [11/13]

◆ String() [12/13]

◆ String() [13/13]

◆ ~String()

Documentation des fonctions membres

◆ _append()

◆ _checkClone()

◆ _copyFields()

◆ _internalUtf16BE()

◆ _removeImplReference()

◆ _removeReferenceIfNeeded()

◆ _resetFields()

◆ _viewFromConstChar()

◆ bytes()

◆ clone()

◆ collapseWhiteSpace()

◆ concat() [1/4]

◆ concat() [2/4]

◆ concat() [3/4]

◆ concat() [4/4]

◆ contains()

◆ empty()

◆ endsWith()

◆ format() [1/10]

◆ format() [2/10]

◆ format() [3/10]

◆ format() [4/10]

◆ format() [5/10]

◆ format() [6/10]

◆ format() [7/10]

◆ format() [8/10]

◆ format() [9/10]

◆ format() [10/10]

◆ fromNumber() [1/10]

◆ fromNumber() [2/10]

◆ fromNumber() [3/10]

◆ fromNumber() [4/10]

◆ fromNumber() [5/10]

◆ fromNumber() [6/10]

◆ fromNumber() [7/10]

◆ fromNumber() [8/10]

◆ fromNumber() [9/10]

◆ fromNumber() [10/10]

◆ fromUtf8()

◆ hashCode()

◆ internalDump()

◆ isLess()

◆ join()

◆ len()

◆ length()

◆ localstr()

◆ lower()

◆ null()

◆ operator StringView()

◆ operator+() [1/13]

◆ operator+() [2/13]

◆ operator+() [3/13]

◆ operator+() [4/13]

◆ operator+() [5/13]

◆ operator+() [6/13]

◆ operator+() [7/13]

◆ operator+() [8/13]

◆ operator+() [9/13]