Vue sur une chaîne de caractères UTF-8. Plus de détails...

#include <arccore/base/StringView.h>

Fonctions membres publiques
	StringView ()=default
	Crée une vue sur une chaîne vide.

	StringView (const char *str) ARCCORE_NOEXCEPT
	Créé une vue à partir de str codé en UTF-8. str peut être nul.

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

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

constexpr	StringView (const StringView &str)=default
	Opérateur de recopie.

constexpr StringView &	operator= (const StringView &str)=default
	Copie la vue str dans cette instance.

StringView &	operator= (const char *str) ARCCORE_NOEXCEPT
	Créé une vue à partir de str codé en UTF-8.

StringView &	operator= (std::string_view str) ARCCORE_NOEXCEPT
	Créé une vue à partir de str codé en UTF-8.

constexpr StringView &	operator= (Span< const Byte > str) ARCCORE_NOEXCEPT
	Créé une vue à partir de str codé en UTF-8.

	~StringView ()=default
	Libère les ressources.

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

constexpr Int64	length () const ARCCORE_NOEXCEPT
	Longueur en octet de la chaîne de caractères.

constexpr Int64	size () const ARCCORE_NOEXCEPT
	Longueur en octet de la chaîne de caractères.

constexpr bool	empty () const ARCCORE_NOEXCEPT
	Vrai si la chaîne est nulle ou vide.

std::string_view	toStdStringView () const ARCCORE_NOEXCEPT
	Retourne une vue de la STL de la vue actuelle.

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

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

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

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

ARCCORE_BASE_EXPORT bool	operator== (const StringView &a, const StringView &b)
	Compare deux vues.

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

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

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

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

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

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

Description détaillée

Vue sur une chaîne de caractères UTF-8.

Cette classe est similaire à std::string_view du C++17 dans le sens où elle ne conserve qu'un pointeur sur une donnée mémoire gérée par une autre classe. Les instances de cette classe ne doivent donc pas être conservées. La différence principale se situe au niveau de l'encodage qui est obligatoirement UTF-8 avec cette classe.

Note: Comme la classe std::string_view, le tableau bytes() ne contient pas nécessairement de zéro terminal. Cela signifie entre autre qu'il ne faut donc pas utiliser cette classe pour passer des paramètres à des fonctions C.

Définition à la ligne 46 du fichier StringView.h.

Documentation des constructeurs et destructeur

◆ StringView() [1/3]

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

inline

Créé une vue à partir de str codé en UTF-8. str peut être nul.

Définition à la ligne 53 du fichier StringView.h.

Références StringView().

◆ StringView() [2/3]

Arcane::StringView::StringView ( std::string_view str )

inline

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

Définition à la ligne 56 du fichier StringView.h.

◆ StringView() [3/3]

Arcane::StringView::StringView ( Span< const Byte > str )

inlineconstexpr

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

Définition à la ligne 59 du fichier StringView.h.

Documentation des fonctions membres

◆ bytes()

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

inlineconstexpr

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

Avertissement: L'instance retournée ne contient pas de zéro terminal.; 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 96 du fichier StringView.h.

Référencé par Arcane::StringViewToDoubleConverter::_getDoubleValueWithFromChars(), et Arcane::MeshUtils::dumpSynchronizerTopologyJSON().

◆ empty()

bool Arcane::StringView::empty ( ) const

inlineconstexpr

Vrai si la chaîne est nulle ou vide.

Définition à la ligne 105 du fichier StringView.h.

Références size().

Référencé par Arcane::builtInGetValue(), Arcane::Accelerator::AcceleratorRuntimeInitialisationInfo::setAcceleratorRuntime(), Arcane::Convert::ScalarType< T >::tryParse(), et Arcane::Convert::ScalarType< T >::tryParseIfNotEmpty().

◆ length()

Int64 Arcane::StringView::length ( ) const

inlineconstexpr

Longueur en octet de la chaîne de caractères.

Définition à la ligne 99 du fichier StringView.h.

Référencé par subView().

◆ operator=() [1/3]

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

inline

Créé une vue à partir de str codé en UTF-8.

Définition à la ligne 66 du fichier StringView.h.

Références operator=(), et StringView().

◆ operator=() [2/3]

StringView & Arcane::StringView::operator= ( Span< const Byte > str )

inlineconstexpr

Créé une vue à partir de str codé en UTF-8.

Définition à la ligne 78 du fichier StringView.h.

Références StringView().

◆ operator=() [3/3]

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

inline

Créé une vue à partir de str codé en UTF-8.

Définition à la ligne 72 du fichier StringView.h.

Références StringView().

◆ size()

Int64 Arcane::StringView::size ( ) const

inlineconstexpr

Longueur en octet de la chaîne de caractères.

Définition à la ligne 102 du fichier StringView.h.

Référencé par Arcane::StringViewToDoubleConverter::_getDoubleValue(), et empty().

◆ subView() [1/2]

StringView Arcane::StringView::subView ( Int64 pos ) const

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

Définition à la ligne 36 du fichier StringView.cc.

Références length(), StringView(), et subView().

Référencé par subView().

◆ subView() [2/2]

StringView Arcane::StringView::subView	(	Int64	pos,
		Int64	len ) const

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

Définition à la ligne 45 du fichier StringView.cc.

Références StringView().

◆ toStdStringView()

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

inline

Retourne une vue de la STL de la vue actuelle.

Définition à la ligne 112 du fichier StringView.h.

Référencé par operator<, et operator==.

◆ writeBytes()

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

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

Définition à la ligne 27 du fichier StringView.cc.

Référencé par operator<<.

Documentation des fonctions amies et associées

◆ operator!= [1/3]

bool operator!=	(	const char *	a,
		const StringView &	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 152 du fichier StringView.h.

Références operator==, et StringView().

◆ operator!= [2/3]

bool operator!=	(	const StringView &	a,
		const char *	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 168 du fichier StringView.h.

Références operator==, et StringView().

◆ operator!= [3/3]

bool operator!=	(	const StringView &	a,
		const StringView &	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 133 du fichier StringView.h.

Références operator==, et StringView().

◆ operator<

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

friend

Compare deux chaînes unicode.

Valeurs retournées

true	si a<b
false	sinon. \relate String

Définition à la ligne 94 du fichier StringView.cc.

Références StringView(), et toStdStringView().

◆ operator<<

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

friend

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

Définition à la ligne 56 du fichier StringView.cc.

Références StringView(), et writeBytes().

◆ operator== [1/3]

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

friend

Compare deux chaînes unicode.

Valeurs retournées

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

Définition à la ligne 78 du fichier StringView.cc.

Références operator==, et StringView().

◆ operator== [2/3]

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

friend

Compare deux chaînes unicode.

Valeurs retournées

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

Définition à la ligne 86 du fichier StringView.cc.

Références operator==, et StringView().

◆ operator== [3/3]

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

friend

Compare deux vues.

Valeurs retournées

true	si elles sont égales,
false	sinon.

Définition à la ligne 67 du fichier StringView.cc.

Références operator==, StringView(), et toStdStringView().

Référencé par operator!=, operator!=, operator!=, operator==, operator==, et operator==.

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

Fonctions membres publiques

Amis

Description détaillée

Documentation des constructeurs et destructeur

◆ StringView() [1/3]

◆ StringView() [2/3]

◆ StringView() [3/3]

Documentation des fonctions membres

◆ bytes()

◆ empty()

◆ length()

◆ operator=() [1/3]

◆ operator=() [2/3]

◆ operator=() [3/3]

◆ size()

◆ subView() [1/2]

◆ subView() [2/2]

◆ toStdStringView()

◆ writeBytes()

Documentation des fonctions amies et associées

◆ operator!= [1/3]

◆ operator!= [2/3]

◆ operator!= [3/3]

◆ operator<

◆ operator<<

◆ operator== [1/3]

◆ operator== [2/3]

◆ operator== [3/3]