Difference between revisions of "ReNamer:Pascal Script:Types"

From den4b Wiki
Jump to navigation Jump to search
(→‎String types: Default encoding and type conversions)
 
(11 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
{{Template:Expand}}
+
{{Go|up=ReNamer:Pascal Script|next=ReNamer:Pascal Script:Functions}}
  
 
This page lists and explains all supported types in [[ReNamer:Pascal Script|Pascal Script]] used within ReNamer.
 
This page lists and explains all supported types in [[ReNamer:Pascal Script|Pascal Script]] used within ReNamer.
Line 8: Line 8:
 
! Type
 
! Type
 
! Size
 
! Size
−
! Range
+
! Lowest Value
 +
! Highest Value
 
|-
 
|-
 
| '''Byte'''
 
| '''Byte'''
 
| 1 byte
 
| 1 byte
−
| align="center" | 0 .. 255
+
| align="center" | 0
 +
| align="center" | 255
 
|-
 
|-
 
| '''ShortInt'''
 
| '''ShortInt'''
 
| 1 byte
 
| 1 byte
−
| align="center" | -128 .. 127
+
| align="center" | -128
 +
| align="center" | 127
 
|-
 
|-
 
| '''Word'''
 
| '''Word'''
 
| 2 bytes
 
| 2 bytes
−
| align="center" | 0 .. 65535
+
| align="center" | 0
 +
| align="center" | 65,535
 
|-
 
|-
 
| '''SmallInt'''
 
| '''SmallInt'''
 
| 2 bytes
 
| 2 bytes
−
| align="center" | -32768 .. 32767
+
| align="center" | -32,768
 +
| align="center" | 32,767
 
|-
 
|-
 
| '''Cardinal'''
 
| '''Cardinal'''
 
| 4 bytes
 
| 4 bytes
−
| align="center" | 0 .. 4294967295
+
| align="center" | 0
 +
| align="center" | 4,294,967,295
 
|-
 
|-
 
| '''Integer'''
 
| '''Integer'''
 
| 4 bytes
 
| 4 bytes
−
| align="center" | -2147483648 .. 2147483647
+
| align="center" | -2,147,483,648
 +
| align="center" | 2,147,483,647
 +
|-
 +
| '''Int64'''
 +
| 8 bytes
 +
| align="center" | -9,223,372,036,854,775,808
 +
| align="center" | 9,223,372,036,854,775,807
 
|}
 
|}
  
Line 62: Line 74:
 
|-
 
|-
 
| '''Char'''
 
| '''Char'''
−
| Stores a single Ansi character
+
| Stores a single 8-bit character.
 
|-
 
|-
 
| '''String'''
 
| '''String'''
−
| Holds a sequence of Ansi characters of any length
+
| Holds a sequence of 8-bit characters. Commonly used for ANSI or UTF-8 encoded text.
 +
|-
 +
| '''AnsiChar'''
 +
| Alias for ''Char'' type.
 +
|-
 +
| '''AnsiString'''
 +
| Alias for ''String'' type.
 
|-
 
|-
 
| '''WideChar'''
 
| '''WideChar'''
−
| Stores a single Unicode character
+
| Stores a single 16-bit character.
 
|-
 
|-
 
| '''WideString'''
 
| '''WideString'''
−
| Holds a sequence of Unicode characters of any length
+
| Holds a sequence of 16-bit characters. Commonly used for UCS-2 or UTF-16 encoded text.
 +
|-
 +
| '''UnicodeChar'''
 +
| Alias for ''WideChar'' type.
 +
|-
 +
| '''UnicodeString'''
 +
| Alias for ''WideString'' type.
 
|}
 
|}
  
−
'''Note:''' [[Unicode]] article highlights the difference between Unicode and Ansi.
+
The default encoding for String/AnsiString type and the conversion process to/from UnicodeString/WideString type differ between versions of ReNamer.
 +
 
 +
{| class="wikitable"
 +
! ReNamer version
 +
! Default encoding for AnsiString type
 +
! Conversion between WideString and AnsiString types
 +
|-
 +
| 7.0 and later
 +
| UTF8
 +
| Automatic, on assignment
 +
|-
 +
| Prior to 7.0
 +
| Active [https://en.wikipedia.org/wiki/Windows_code_page system code page]
 +
| Manual, using conversion functions
 +
|}
  
−
== Other types ==
+
The [[Unicode]] article highlights the differences between various encodings.
 +
 
 +
== Mixed types ==
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 83: Line 123:
 
|-
 
|-
 
| '''Boolean'''
 
| '''Boolean'''
−
| Provides an enumeration of the logical '''True''' and '''False''' values
+
| Provides an enumeration of the logical '''True''' and '''False''' values.
 
|-
 
|-
 
| '''Array'''
 
| '''Array'''
−
| Single and multi dimensional indexable sequences of data
+
| Single and multi dimensional indexable sequences of data.
 
|-
 
|-
 
| '''Record'''
 
| '''Record'''
−
| Provides means of collecting together a set of different data types into one named structure
+
| Provides means of collecting together a set of different data types into one named structure.
 
|-
 
|-
 
| '''Variant'''
 
| '''Variant'''
−
| Provides a flexible general purpose data type
+
| Provides a flexible general purpose data type.
 +
|-
 +
| '''PChar'''
 +
| Pointer to a ''Char'' value, and can also be used to point to characters within a string.
 
|}
 
|}
  
−
== Enumerations and Sets ==
+
== Extra types ==
  
−
For example, the Boolean data type is itself an enumeration, with two possible values: True and False. If you try to assign a different value to a Boolean variable, the code will not compile.
+
Several extra types have been defined to simplify the use of some functions.
  
 
{| class="wikitable"
 
{| class="wikitable"
−
! Example
+
! Type
−
! Description  
+
! Declared as
 +
! Description
 +
|-
 +
| '''TDateTime'''
 +
| Double
 +
| Represents a date and time.
 +
|-
 +
| <strike>'''TStringsArray'''</strike>
 +
| Array of WideString
 +
| Indexed list of ''WideString'' values.<br/>''Deprecated in v5.74.4 Beta. Please use TWideStringArray instead.''
 +
|-
 +
| '''TWideStringArray'''
 +
| Array of WideString
 +
| Indexed list of ''WideString'' values.<br/>''Added in v5.74.4 Beta. Replaces ambiguous TStringsArray type.''
 +
|-
 +
| '''TAnsiStringArray'''
 +
| Array of AnsiString
 +
| Indexed list of ''AnsiString'' values.<br/>''Added in v5.74.4 Beta.''
 
|-
 
|-
−
|
+
| '''TIntegerArray'''
 +
| Array of Integer
 +
| Indexed list of ''Integer'' values.<br/>''Added in v7.3.0.4 Beta.''
 +
|}
 +
 
 +
== Enumerations and Sets ==
 +
 
 +
An enumeration is simply a fixed range of named values.
 +
 
 +
For example, the fundamental ''Boolean'' data type can be considered as an enumeration consisting of two values: ''True'' and ''False''.
 +
 
 +
A variable of an enumeration type can be assigned a single value from the enumeration.
 +
 
 
<pre>
 
<pre>
 
type
 
type
Line 116: Line 188:
 
</pre>
 
</pre>
  
−
| An enumeration is simply a fixed range of named values.
+
Sets allow you to defined variables which can hold multiple values out of the enumeration.
−
|-
+
 
−
|
 
 
<pre>
 
<pre>
 
type
 
type
Line 131: Line 202:
 
end.
 
end.
 
</pre>
 
</pre>
−
| Whereas enumerations allow a variable to have one, and only one, value from a fixed number of values, sets allow you to have any combination of the given values
 
−
|}
 
  
−
== Custom types ==
 
  
−
Several types are custom defined to simplify the usage of some functions.
 
  
−
{| class="wikitable"
 
−
! Type
 
−
! Declared as
 
−
! Description
 
−
|-
 
−
| '''TDateTime'''
 
−
| Double
 
−
| Holds date and time.
 
−
|-
 
−
| '''TStringsArray'''
 
−
| Array of WideString
 
−
| Holds an indexable sequence of WideString.
 
−
|}
 
 
[[Category:ReNamer]]
 
[[Category:ReNamer]]

Latest revision as of 12:41, 23 December 2022

This page lists and explains all supported types in Pascal Script used within ReNamer.

Integer types

Type Size Lowest Value Highest Value
Byte 1 byte 0 255
ShortInt 1 byte -128 127
Word 2 bytes 0 65,535
SmallInt 2 bytes -32,768 32,767
Cardinal 4 bytes 0 4,294,967,295
Integer 4 bytes -2,147,483,648 2,147,483,647
Int64 8 bytes -9,223,372,036,854,775,808 9,223,372,036,854,775,807

Floating point types

Type Size Range
Single 4 bytes 1.5 x 10-45 .. 3.4 x 1038
Double 8 bytes 5.0 x 10-324 .. 1.7 x 10308
Extended 10 bytes 3.6 x 10-4951 .. 1.1 x 104932

String types

Type Description
Char Stores a single 8-bit character.
String Holds a sequence of 8-bit characters. Commonly used for ANSI or UTF-8 encoded text.
AnsiChar Alias for Char type.
AnsiString Alias for String type.
WideChar Stores a single 16-bit character.
WideString Holds a sequence of 16-bit characters. Commonly used for UCS-2 or UTF-16 encoded text.
UnicodeChar Alias for WideChar type.
UnicodeString Alias for WideString type.

The default encoding for String/AnsiString type and the conversion process to/from UnicodeString/WideString type differ between versions of ReNamer.

ReNamer version Default encoding for AnsiString type Conversion between WideString and AnsiString types
7.0 and later UTF8 Automatic, on assignment
Prior to 7.0 Active system code page Manual, using conversion functions

The Unicode article highlights the differences between various encodings.

Mixed types

Type Description
Boolean Provides an enumeration of the logical True and False values.
Array Single and multi dimensional indexable sequences of data.
Record Provides means of collecting together a set of different data types into one named structure.
Variant Provides a flexible general purpose data type.
PChar Pointer to a Char value, and can also be used to point to characters within a string.

Extra types

Several extra types have been defined to simplify the use of some functions.

Type Declared as Description
TDateTime Double Represents a date and time.
TStringsArray Array of WideString Indexed list of WideString values.
Deprecated in v5.74.4 Beta. Please use TWideStringArray instead.
TWideStringArray Array of WideString Indexed list of WideString values.
Added in v5.74.4 Beta. Replaces ambiguous TStringsArray type.
TAnsiStringArray Array of AnsiString Indexed list of AnsiString values.
Added in v5.74.4 Beta.
TIntegerArray Array of Integer Indexed list of Integer values.
Added in v7.3.0.4 Beta.

Enumerations and Sets

An enumeration is simply a fixed range of named values.

For example, the fundamental Boolean data type can be considered as an enumeration consisting of two values: True and False.

A variable of an enumeration type can be assigned a single value from the enumeration. 

type
  TDay = (Mon, Tue, Wed, Thu, Fri, Sat, Sun);
var
  Day: TDay;
begin
  Day := Mon;
  if Day <> Tue then
    Day := Wed;
end.

Sets allow you to defined variables which can hold multiple values out of the enumeration. 

type
  TDay = (Mon, Tue, Wed, Thu, Fri, Sat, Sun);
  TDays = set of TDay;
var
  Days: TDays;
begin
  Days := [Mon, Tue, Wed];
  if Sun in Days then
    Days := Days - [Sun];
end.
Retrieved from "http://www.den4b.com/w/index.php?title=ReNamer:Pascal_Script:Types&oldid=3506"