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

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

Graphe de collaboration de Arccore::StringView:

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.

Attributs privés
Span< const Byte >	m_v

Amis
ARCCORE_BASE_EXPORT std::ostream &	operator<< (std::ostream &o, const StringView &)
	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]

Arccore::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.

◆ StringView() [2/3]

Arccore::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]

constexpr Arccore::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()

constexpr Span< const Byte > Arccore::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.

◆ empty()

constexpr bool Arccore::StringView::empty ( ) const

inlineconstexpr

Vrai si la chaîne est nulle ou vide.

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

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

◆ length()

constexpr Int64 Arccore::StringView::length ( ) const

inlineconstexpr

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

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

◆ operator=() [1/3]

StringView & Arccore::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.

◆ operator=() [2/3]

constexpr StringView & Arccore::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.

◆ operator=() [3/3]

StringView & Arccore::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.

◆ size()

constexpr Int64 Arccore::StringView::size ( ) const

inlineconstexpr

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

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

◆ toStdStringView()

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

inline

Retourne une vue de la STL de la vue actuelle.

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

◆ writeBytes()

void Arccore::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érences Arccore::SpanImpl< T, SizeType, Extent, MinValue >::data(), et Arccore::SpanImpl< T, SizeType, Extent, MinValue >::size().

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.

◆ 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.

◆ 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.

◆ 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 74 du fichier StringView.cc.

◆ 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 36 du fichier StringView.cc.

◆ 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 58 du fichier StringView.cc.

◆ 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 66 du fichier StringView.cc.

◆ 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 47 du fichier StringView.cc.

Documentation des données membres

◆ m_v

Span<const Byte> Arccore::StringView::m_v

private

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

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

Fonctions membres publiques

Attributs privés

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()

◆ 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]

Documentation des données membres

◆ m_v