Difference between revisions of "Const"

From Free Pascal wiki
Jump to navigationJump to search
Line 17: Line 17:
  
 
== Array of Const ==
 
== Array of Const ==
A function can declare a parameter as an '''array of const'''. This allows a a routine to effectively take a variable amount of different types of parameters, via a single variable-length array parameter. At run-time when the function/procedure is called, the actual elements of the array are turned into variant records of type [[TVarRec]]. The called routine can use High() to determine the number of elements in the array and look at the VType field of the each TVarRec element, to determine the type it contains. Record types cannot be passed as part of an '''array of const''', but simple types, classes and interfaces can be.
+
A function can declare a parameter as an '''array of const'''. This allows a a routine to effectively take a variable amount of different types of parameters, via a single variable-length array parameter. At run-time when the function/procedure is called, the actual elements of the array are turned into variant records of type [[TVarRec]]. The called routine can use High() to determine the number of elements in the array and look at the VType field of each TVarRec element, to determine the type it contains. Record types cannot be passed as part of an '''array of const''', but simple types, classes and interfaces can be.
  
 
This feature is only available in [[Compiler Mode|compiler mode]] ObjFPC or Delphi.
 
This feature is only available in [[Compiler Mode|compiler mode]] ObjFPC or Delphi.

Revision as of 14:14, 26 July 2016

Deutsch (de) English (en) español (es) suomi (fi) français (fr) 中文(中国大陆)‎ (zh_CN)

The const keyword has three uses in a Pascal program:

  • to start a constant declaration section
  • to declare const parameter for a function or procedure
  • to declare a function with a variable number of parameters passed via a variable-sized array of different element types

Const Section

The declaration const in a Pascal program is used to inform the compiler that certain identifiers which are being declared are constants, that is, they are initialized with a specific value at compile time as opposed to a variable which is initialized at run time.

However, the default setting in Free Pascal is to allow const identifiers to be re-assigned to. In order to make them unchangeable, the {$J} (short form) or {$WriteableConst} (long form) compiler directives must be used to turn off the ability to assign to constant identifiers. That is {$J-} or {$WriteableConst OFF} .

In some Pascal compilers, the Const declaration is used to define variables which are initialized at compile time to a certain specific value, and that the variables so defined can change as the program executes. This can be used for initializing arrays at compile time as opposed to setting values when the program is executed.

Const Parameter

A function or procedure parameter may be declared const. Any assignment to a const parameter within a procedure or function and the compiler will flag it as an error: "Can't assign values to const variable". Declaring a parameter as const allows the compiler the possibility to do optimizations it couldn't do otherwise, such as passing by reference while retaining the semantics of passing by value. A const parameter cannot be passed to another function or procedure that requires a variable parameter.

Array of Const

A function can declare a parameter as an array of const. This allows a a routine to effectively take a variable amount of different types of parameters, via a single variable-length array parameter. At run-time when the function/procedure is called, the actual elements of the array are turned into variant records of type TVarRec. The called routine can use High() to determine the number of elements in the array and look at the VType field of each TVarRec element, to determine the type it contains. Record types cannot be passed as part of an array of const, but simple types, classes and interfaces can be.

This feature is only available in compiler mode ObjFPC or Delphi.

See Also

Constref