System.UniqueString
Delphi
procedure UniqueString(var str: UnicodeString); overload;
procedure UniqueString(var str: _WideStr);
procedure UniqueString(var str: _AnsiStr);
C++
extern DELPHI_PACKAGE void __fastcall UniqueString(UnicodeString &Str)/* overload */;
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
procedure function |
public | System.pas System.hpp |
System | System |
Description
Vérifie que le compteur de références d'une chaîne donnée est à 1.
UniqueString impose la valeur 1 au compteur de références sur une chaîne, en copiant la chaîne en mémoire si nécessaire. Pour la gestion de chaînes classiques, il n'est pas nécessaire d'appeler UniqueString. La routine UniqueString est utilisée seulement dans les cas où une application modifie le contenu d'une chaîne après :
- Le transtypage de la chaîne en un PAnsiChar ou PWideChar dans Delphi.
- L'utilisation des méthodes c_str(), t_str() et data() de UnicodeString ou de AnsiString, ou de la méthode c_bstr() de WideString dans C++. Il est préférable d'utiliser data() au lieu de c_str() car c_str() renvoie une chaîne vide pour un UnicodeString ou un AnsiString NULL.