[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 35

`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.

Documentation generated on: Feb 26 2014