System.AnsiStrings.StrNew

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function StrNew(const Str: PAnsiChar): PAnsiChar;

C++

extern DELPHI_PACKAGE char * __fastcall StrNew(const char * Str)/* overload */;

Propriétés

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

Description

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