System.SysUtils.AnsiStrAlloc

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function AnsiStrAlloc(Size: Cardinal): PAnsiChar;

C++

extern DELPHI_PACKAGE char * __fastcall AnsiStrAlloc _DEPRECATED_ATTRIBUTE1("Moved to the AnsiStrings unit") (unsigned Size);

Propriétés

Type Visibilité  Source Unité  Parent
function public
System.SysUtils.pas
System.SysUtils.hpp
System.SysUtils System.SysUtils

Description

Avertissement : AnsiStrAlloc est obsolète. Veuillez utiliser AnsiStrings.

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.

Voir aussi