System.SysUtils.StrAlloc

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function StrAlloc(Size: Cardinal): PChar;

C++

extern DELPHI_PACKAGE System::WideChar * __fastcall StrAlloc(unsigned Size);

Propriétés

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

Description

Alloue un tampon pour une chaîne à zéro terminal et renvoie un pointeur sur son premier caractère.

StrAlloc alloue un tampon pour une chaîne à zéro terminal (AZT) dont la taille ne peut excéder Size - 1 (1 octet est réservé pour le caractère de fin). 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 StrAlloc, il doit être restitué via StrDispose.

Comme les chaînes AnsiString (longues chaînes) sont implicitement terminées par un zéro et dynamiquement allouées, l'utilisation de StrAlloc est dépréciée.

Voir aussi