System.SysUtils.WideStrAlloc

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function WideStrAlloc(Size: Cardinal): PWideChar;

C++

extern DELPHI_PACKAGE System::WideChar * __fastcall WideStrAlloc(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 étendue, terminée par le caractère NULL, et renvoie un pointeur sur son premier caractère.

WideStrAlloc alloue un tampon pour une chaîne terminée par le caractère NULL d'une longueur maximale de Size - 1 (2 octets doivent être réservés 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 * 2) + 4. Si l'espace pour une chaîne est alloué à l'aide de WideStrAlloc, il doit être restitué par le biais de StrDispose.

Comme les chaînes WideString sont implicitement terminées par un caractère NULL et dynamiquement allouées, l'utilisation de WideStrAlloc est dépréciée.

Voir aussi