[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index] Reference for unit 'sysutils' (#rtl)

strnew

Allocate room for new null-terminated string.

Declaration

Source position: syspchh.inc line 41

function strnew(

  p: PChar

):PChar;

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.
The latest version of this document can be found at lazarus-ccr.sourceforge.net.