System.SysUtils.StrNew

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function StrNew(const Str: PAnsiChar): PAnsiChar;
function StrNew(const Str: PWideChar): PWideChar;

C++

extern DELPHI_PACKAGE char * __fastcall StrNew _DEPRECATED_ATTRIBUTE1("Moved to the AnsiStrings unit") (const char * Str)/* overload */;

Propriétés

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

Description

Avertissement : La version ANSI de StrNew est obsolète. Veuillez utiliser l’unité AnsiStrings.

Alloue de l'espace sur et copie une chaîne dans le tas, renvoyant un pointeur sur la chaîne.

StrNew alloue une copie de Str dans le tas.

Si Str est à nil (Delphi) ou NULL (C++) ou pointe sur une chaîne vide, StrNew renvoie un pointeur sur une nouvelle chaîne vide.

Sinon, StrNew duplique Str en récupérant l'espace nécessaire par un appel à StrAlloc, et renvoie un pointeur sur la duplication de la chaîne.

La taille allouée est la longueur de Str + 5 octets.

Voir aussi