Unit 'sysutils' Package
[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index] [#rtl]

strnew

Allocate room for new null-terminated string.

Declaration

Source position: syspchh.inc line 36

function StrNew(

  p: PAnsiChar

):PAnsiChar; overload;

function strnew(

  p: PWideChar

):PWideChar; overload;

Description

Copies P to the Heap, and returns a pointer to the copy.

Errors

Returns Nil if no memory was available for the copy.

See also

StrCopy

  

Copy a null-terminated string.

StrDispose

  

Dispose of a null-terminated string on the heap.

Example

Program Example16;

Uses strings;

{ Program to demonstrate the StrNew function. }

Const P1 : PChar = 'This is a PChar string';

var P2 : PChar;

begin
  P2:=StrNew (P1);
  If P1=P2 then
    writeln ('This can''t be happening...')
  else
    writeln ('P2 : ',P2);
  StrDispose(P2);  
end.

Documentation generated on: Dec 27 2024