String

This is an old revision of String, edited by FPC user at . The current revision is 32238.

/* Alias */ length specification will override the compiler setting for String alias

String is a type which may contain characters.

Alias

String is an alias for ShortString or AnsiString depending on a compiler setting.

If compiler directive {$H} or compiler directive {$LongStrings} has been used with an "on" parameter ( {$H+} or {$LongStrings ON} ), then a String type is the same as an AnsiString type, if not ( {$H-} or {$LongStrings OFF} ), it is a ShortString type. What String is an alias for can also be set by the -Sh command line option.

NOTE: The {$mode} compiler directive will also set the String alias. After the compiler mode is set to FPC (the default), ObjFPC, MacPAS or TP, String will be an alias for ShortString. After the compiler mode is set to Delphi, String will be an alias for AnsiString. So the String alias setting should be made following the compiler mode setting to prevent it from being overridden:

{$H+}            // String is an alias for AnsiString
{$mode ObjFPC}   // also affects String alias - String is now an alias for ShortString
{$H+}            // String is now an alias for AnsiString

A String variable declared with a length specifier will always be a ShortString regardless of the compiler setting for String alias.

{$H+}            // String is an alias for AnsiString
Var
   name : String[25]; // name is a ShortString variable since a length specification overrides the alias setting

In the future there may be a compiler directive to set String to refer to a Unicode string type (UTF-8 or UTF-16).

ShortString/AnsiString

The potential alias types for String - ShortString and AnsiString - differ with respect to length:

See also

navigation bar: data types

simple data types boolean byte cardinal char currency double dword extended int8 int16 int32 int64 integer longint real shortint single smallint pointer qword word
complex data types array class object record set string shortstring