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

# NewStr

Allocate a new ansistring on the heap.

## Declaration

Source position: sysstrh.inc line 72

`function NewStr(`
`const S: String`
`):PString; overload;`

## Description

NewStr assigns a new dynamic string on the heap, copies S into it, and returns a pointer to the newly assigned string.

This function is obsolete, and shouldn't be used any more. The AnsiString mechanism also allocates ansistrings on the heap, and should be preferred over this mechanism.

For an example, see AssignStr.

## Errors

If not enough memory is present, an EOutOfMemory exception will be raised.

## See also

AssignStr |  | Assigns an ansistring to a null-terminated string.
DisposeStr |  | Dispose an ansistring from the heap.

The latest version of this document can be found at lazarus-ccr.sourceforge.net.