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

# AssignStr

Assigns an ansistring to a null-terminated string.

## Declaration

Source position: sysstrh.inc line 69

`procedure AssignStr(`
`var P: PString;`
`const S: string`
`);`

## Description

AssignStr allocates S to P. The old value of P is disposed of.

This function is provided for Delphi compatibility only. AnsiStrings are managed on the heap and should be preferred to the mechanism of dynamically allocated strings.

## Errors

None.

## See also

NewStr |  | Allocate a new ansistring on the heap.
AppendStr |  | Append one ansistring to another.
DisposeStr |  | Dispose an ansistring from the heap.

## Example

    Program Example63;

    { This program demonstrates the AssignStr function }
    {$H+}

    Uses sysutils;

    Var P : PString;

    Begin
     P:=NewStr('A first AnsiString');
     Writeln ('Before: P = "',P^,'"');
     AssignStr(P,'A Second ansistring');
     Writeln ('After : P = "',P^,'"');
     DisposeStr(P);
    End.

Documentation generated on: Feb 26 2014