Recital Variables and Constants

From Recital Documentation Wiki
Revision as of 11:51, 12 November 2009 by Yvonnemilne (Talk | contribs)

Jump to: navigation, search

Recital Variables and Constants

An Introduction to Recital Variables

Naming and Creating a Variable

Variable names must begin with a letter (A-Z, a-z) or an underscore (-), followed by any combination of letters, digits or underscores. The variable name can be of any length, but only the first 32 characters are significant, so these must be unique. Recital ignores the case of letters, so m_var, M_VAR, and m_VaR would all be treated as the same memory variable name. The name given to a variable has no bearing on the type of data that is, or can be, stored in it. In fact, the type of data stored in a particular variable can be changed at any time, although this needs to be carefully controlled so that inappropriate operations are not attempted. e.g.

m_var = 1234
m_var = 'a character value'
? m_var + 100

Values can be assigned to memory variables without those memory variables having been pre-declared, but it is generally accepted that the pre-declaration of memory variables is good programming practice. Variables can be declared as public, private or local and will be initialized as a logical false (.F.).

public cVar1
private cVar2
local cVar3

Assigning a Value to a Variable

Values are assigned to memory variables using the store command, the equals = operator or the inline assignment := operator.

store 'new value' to cVAR1
cVAR1 = 'newer value'
cVAR1 := 'newest value'

Note that the store command can assign a value to more than one memory variable in a single command.

store 'new value' to cVAR1, cVAR2

Accessing a Variable

Variables can be accessed using the variable name. The memory variable pointer m-> or m. prefix is optional.

m_var = 1234
echo m_var
echo m.m_var
echo m->m_var

Changing the Type of a Variable

The type() or vartype() functions can be used to determine the data type of any variable.

Checking Whether a Variable Exists

The isset() function can be used to check whether a variable exists.

if isset(m_var)
  // m_var exists
endif

Variable Scope

Public variables are globally visible, they are accessible and can be changed from any part of an application. If the application is run from the Interactive Prompt, then any public variables can still be accessed even after the application ends. Any variables created at the Interactive Prompt are automatically created as public variables.

Private variables are only visible within the declaring module (program, procedure, User Defined Function) and any modules called by that declaring module. Any variables accessed within a module that are not pre-declared are automatically created as private variables. When the module returns, then all of the memory variables and arrays that were declared by the private command are released.

Local variables are only visible within the declaring module and are released when the module returns. Local variables differ from private variables in that a local variable is not visible to lower level procedures or functions.

To manually release a memory variable, use the unset() function:

if isset(m_var)
  unset(m_var)
endif

Understanding Recital Variable Types

Recital Character Variables

Character variables contain a string of ASCII characters up to 65535 characters in length.

The type() function returns 'C' for character variables and the is_string() function returns .T. (true).

cVAR = "Hello World"
? type("cVAR")
C
? is_string(cVAR)
.T.

Recital Numeric Variables

Recital Date Variables

Recital Logical Variables

Recital Datetime Variables

Recital Currency Variables

Recital Constants

Character Constants

A string of ASCII characters up to 65535 characters in length.

Delimited by double quotes "", or single quotes ‘’.

'goodbye'
"RECITAL"
"1234.56"
"12/12/2009"

The type() function returns 'C' for character strings.

Numeric Constants

An integer number of up to 16 digits (0-9) or a floating point number of up to 25 digits (9 are reserved for decimal places) and one decimal point.

1234
1234.56

The type() function returns 'N' for numerics.

Date Constants

A combination of digits and separators delimited by curly braces {}. The format is determined by the set date and set century commands.

// set date is BRITISH, set century is OFF
{21/01/09}
// set date is AMERICAN, set century is ON
{01/21/2009}
// set date is GERMAN, set century is ON
{21/01/2009}
// set date is JAPAN, set century is ON
{2009/21/01}

The type() function returns 'D' for dates.

Logical Constants

A choice of two values, .T. for true, .F. for false

The type() function returns 'L' for logicals.

Datetime Constants

A combination of digits and separators delimited by curly braces {}. The format is determined by the set date and set century commands.

// set date is BRITISH, set century is OFF
{21/01/09 02:11:12 PM}
// set date is AMERICAN, set century is ON
{01/21/2009 05:09:09 AM}
// set date is GERMAN, set century is ON
{21/01/2009 11:30:00 PM}
// set date is JAPAN, set century is ON
{2009/21/01 12:10:10 AM}

The type() function returns 'T' for datetimes.

Currency Constants

A monetary value prefixed with a dollar sign, '$', and consisting of up to 9 digits and 4 decimal places.

$123456789.1234
$99

The type() function returns 'Y' for currency values.