Node:SetLength, Next:SetType, Previous:SetFileTime, Up:Reference

### SetLength

#### Synopsis

    procedure SetLength (var S: String; NewLength: Integer);

#### Description

`SetLength` explicitly assigns a new length `NewLength` to the string parameter `S`. The contents of the string is not changed; if the operation increases the length of the string, the characters appended at the end are undefined.

#### Conforming to

`SetLength` is a Borland Delphi 2.0 extension.

#### Example

    program SetLengthDemo;

    var
      S: String (26);

    begin
      S := 'Hello, world!';
      SetLength (S, Length ('Hello'));
      WriteLn (S);                                           { 'Hello' }

      SetLength (S, 26);
      WriteLn (S);                     { 'Hello, world!(%$xy"!#&~+(/]' }
                                { undefined characters ^^^^^^^^^^^^^^  }

      SetLength (S, 42);       { The overflow is *not* (yet) detected. }
      WriteLn (S);        { This might cause a runtime error or crash. }
    end.

#### See also

Length, String.