System.AnsiStrings.StrNew
Delphi
function StrNew(const Str: PAnsiChar): PAnsiChar;
C++
extern DELPHI_PACKAGE char * __fastcall StrNew(const char * Str)/* overload */;
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
function | public | System.AnsiStrings.pas System.AnsiStrings.hpp |
System.AnsiStrings | System.AnsiStrings |
Description
Alloue de l'espace sur et copie une chaîne dans le tas, renvoyant un pointeur sur la chaîne.
StrNew alloue une copie de Str dans le tas.
Si Str est à nil (Delphi) ou NULL (C++) ou pointe sur une chaîne vide, StrNew renvoie un pointeur sur une nouvelle chaîne vide.
Sinon, StrNew duplique Str en récupérant l'espace nécessaire par un appel à StrAlloc, et renvoie un pointeur sur la duplication de la chaîne.
La taille allouée est la longueur de Str + 5 octets.