System.AnsiStrings.AnsiStrAlloc
Delphi
function AnsiStrAlloc(Size: Cardinal): PAnsiChar;
C++
extern DELPHI_PACKAGE char * __fastcall AnsiStrAlloc(unsigned Size);
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | System.AnsiStrings.pas System.AnsiStrings.hpp |
System.AnsiStrings | System.AnsiStrings |
Description
Alloue un tampon pour une chaîne AnsiString terminée par le caractère NULL et renvoie un pointeur sur son premier caractère.
AnsiStrAlloc alloue un tampon pour une chaîne AnsiString, terminée par le caractère NULL, d'une longueur maximale de Size - 1 (1 octet doit être réservé pour le caractère de terminaison). Le résultat pointe sur l'emplacement où sera stocké le premier caractère de la chaîne. Un nombre sur 32 bits donnant la mémoire totale allouée est stocké dans les quatre octets qui précèdent le premier caractère ; ce nombre est égal à Size + 4. Si l'espace pour une chaîne est alloué à l'aide de AnsiString, il doit être restitué via StrDispose.
Comme les chaînes AnsiString sont implicitement terminées par un caractère NULL et dynamiquement allouées, l'utilisation de AnsiStrAlloc est dépréciée.