System.AnsiStringBase

De RAD Studio API Documentation
Aller à : navigation, rechercher

C++

class RTL_DELPHIRETURN AnsiStringBase

Propriétés

Type Visibilité  Source Unité  Parent
class public dstring.h System System

Description

AnsiStringBase est la classe de base de l'analogie C++ du type chaîne longue de Delphi.

AnsiStringBase fournit un espace pour les méthodes/membres communs à toutes les instanciations de la classe template AnsiStringT<page de code>. AnsiString est lui-même un typedef équivalent à AnsiStringT<0>. Vous ne devez jamais utiliser directement AnsiStringBase.

AnsiStringT est une classe template utilisée lors de la gestion d'un AnsiString Delphi avec une page de code spécifiée.

Delphi utilise plusieurs types chaînes. Un type chaîne long important est généralement connu en tant que AnsiString. Le support de ce type inclut les fonctionnalités suivantes :

  • Les chaînes peuvent être aussi grandes que la mémoire disponible.
  • Une utilisation efficace de la mémoire est garantie au travers des références partagées.
  • Les routines et les opérateurs évaluent les chaînes en fonction des paramètres régionaux locaux.

Malgré son nom, AnsiStringBase n'est pas limité au jeu de caractères ANSI et il peut utiliser tout jeu de caractères supporté par la définition des paramètres régionaux en cours, notamment les jeux de caractères multi-octets et Unicode.

Les variables AnsiStringBase auxquelles il n'a pas été assigné de valeur initiale contiennent une chaîne de longueur nulle.

Pour utiliser les opérateurs de flux C++ (<< et >>) avec AnsiStringBase, vous devez utiliser iostream avant d'inclure system.hpp et AnsiStringT::c_str() pour retourner la représentation interne de la chaîne. L'exemple suivant montre l'usage de AnsiString avec les opérateurs de flux.



# include <iostream>
# include <system.hpp>
int main() {
AnsiString HelloStr = "hello";
std::cout << HelloStr.c_str();
}



Remarque : Delphi supporte aussi AnsiString, mais l'implémente comme un type primitif au lieu d'une classe. UnicodeString devient le type chaîne par défaut. Par défaut, les variables déclarées en tant que chaînes sont de type UnicodeString.

Voir aussi