System.SysUtils.WideStrAlloc
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.