Please enable JavaScript to view this site.

R:BASE 11 Help

Navigation: Reference Index

Data Types

Scroll Prev Top Next More

These data types can be specified within the R:BASE command syntax using the SET VARIABLE command.

 

BIGINT

Holds a 64-bit integer value

Offers a range of ±999,999,999,999,999,999

Delimiters (such as commas) cannot be used in entry

No length is needed

 

BIGNUM

Holds decimal numbers whose precision and scale can be set

When specifying BIGNUM, specify a precision (the total number of digits) from 1 to 38 (default 18) and a scale (the number of decimal places) from zero to any positive integer up to the precision value (default 0)

R:BASE reserves a minimum of forty bytes of internal storage

BIGNUM numbers are stored as DECIMAL

 

BIT

Holds binary data

The default length is 1 bit

The fixed length is 1 to 1,500 bytes

 

BIT VARYING

Maps to VARBIT

 

BITNOTE

Holds binary data

No length is needed

The variable length is 0 to 4,088 bytes of binary data

 

BOOLEAN

Hold true/false values

Internally stored as 0 for false and 1 for true

Accepted values for false include: 0, false, 'false', f

Accepted values for true include: 1, true, 'true', t

 

Notes:

 

oFor multilingual applications, the values of 0 and 1 are recommended.

oThe BOOLEAN operating condition setting specifies that constants (e.g. TRUE, FALSE) in expressions will be treated as type BOOLEAN values. The default is OFF.

 

BSTR

Holds binary string data

String data type that is used by COM (Component Object Model), Automation, and Interop functions

Used to support Unicode in table data

Composite data type that consists of a length prefix, a data string, and a terminator

 

Length Prefix

Consists of a four-byte integer

Occurs immediately before the first character of the data string

Contains the number of bytes in the following data string

Does not include the terminator

 

Data String

Consists of a string of Unicode characters (wide or double-byte characters)

May contain multiple embedded null characters

 

Terminator

Consists of two null characters (0x00)

 

CHAR VARYING

Maps to VARCHAR

 

CHARACTER

Maps to TEXT

 

CURRENCY

Holds monetary values of up to 23 digits represented in the currency format, established using SET CURRENCY

Dollar amounts are in the range ±$99,999,999,999,999.99

Commas or the current delimiter can be used. If no decimal point is included, .00 is assumed

Data is stored as two long integer values, reserving four bytes of internal storage

The negative currency format with parenthesis around the negative value e.g. ($500.00), is not recognized

 

DATE

Holds dates in a 1- to 30-character format based on month, day, and year as established using SET DATE

The minimum and default format to display month, day, and year is MM/DD/YY

The allowable date range is January 1, 3999 BC to December 31, 9999 AD

R:BASE reserves four bytes of internal storage

 

DATETIME

A concatenation of the DATE and TIME data types, resulting in a sequence and display format as set by DATE and TIME

DATETIME cannot be SET directly, but does permit extraction of its value by the DATETIME functions into a DATETIME variable

For example: SET VAR vdatetime = (DATETIME(06/12/93, 12:15:30.123)), results in vdatetime = '06/12/93', 12:15:30.123'

For identification purposes, DATETIME values are automatically stamped into R:BASE databases, also known as the timestamp

DATETIME occupies 8 bytes of internal storage

The time portion of the value does not have to be specified in a DATETIME data type. If omitted, it defaults to 0:0:0

 

DECIMAL

Maps to NUMERIC

 

DOUBLE

Holds double-precision real numbers in the range ±1.7E308 with a precision of up to 15 digits

DOUBLE numbers longer than 15 digits are stored as scientific notation

R:BASE reserves eight bytes of internal storage

Because DOUBLE numbers are stored in a binary form, the displayed value may not be the stored value

Calculations are performed on the stored values

Among numeric data types, DOUBLE provides the greatest range of values

 

GUID

Holds a 128-bit value

Binary global unique identifier, which is represented as a 32 hexadecimal digits

Listed as a group of 8 digits, followed by three groups of 4 digits, followed by a group of 12 digits, for a total of 32 digits, separated by hyphens

As the GUID data type is a binary unique value, it will increase retrieval of data from tables for indexed columns

 

An example of a GUID value is: 8C20005C-0E2A-47E0-B2BE-57E67961628B

 

INTEGER

Holds whole numbers in the range of ±1,999,999,999

Delimiters (such as commas) cannot be used in entry

R:BASE reserves four bytes of internal storage space

 

LONG VARBINARY

Maps to VARBIT

 

LONG VARBIT

Maps to VARBIT

 

LONG VARCHAR

Maps to VARCHAR

 

NOTE

Holds alphanumeric data

The default length is 0, where the length is determined by the data

Holds variable length text of up to 10,000 characters

Maximum length of a NOTE column can be set

Indexes and constraints are allowed on NOTE data types

R:BASE reserves a minimum of four bytes of internal storage space

 

NUMERIC

Holds decimal numbers whose precision and scale can be set

When specifying NUMERIC, specify a precision (the total number of digits) from 1 to 15 (default 9) and a scale (the number of decimal places) from zero to any positive integer up to the precision value (default 0)

R:BASE reserves a minimum of eight bytes of internal storage

NUMERIC numbers are stored as DOUBLE

 

REAL

Holds real number amounts in the range of ±1E38 with six-digit accuracy

Real numbers with up to seven digits are displayed as decimal numbers; for example, 321.414

Real numbers with more than seven digits are represented in scientific notation; for example, 9.8E32

R:BASE reserves four bytes of internal storage space

REAL numbers are stored in a binary form; therefore, the displayed value may not be the actual stored value

Calculations are performed on the stored values

 

SMALLINT

Holds a 16-bit integer value

Offers a range of ±32767

Delimiters (such as commas) cannot be used in entry

No length is needed

 

TEXT

Holds alphanumeric data

The default length is eight characters

The maximum is 1,500 characters

Maximum length of a TEXT column can be set

R:BASE reserves a minimum of four bytes of internal storage space

 

TIME

Holds time values in a 1- to 20-character format based on hours, minutes, and seconds, established using SET TIME

The minimum format to display hours, minutes, and seconds is HH:MM:SS

TIME can be specified up to thousandths of a second

Time can be displayed or entered as a 12- or 24-hour clock

R:BASE reserves four bytes of internal storage

 

VARBINARY

Maps to VARBIT

 

VARBIT

Holds binary data

No length is needed

Is ideal for storing external files, like images, PDF files, etc.

 

VARCHAR

Holds alphanumeric data

No length is needed

Is ideal for storing large text data

 

WIDENOTE

Holds Unicode data

The default length is 0, where the length is determined by the data

Holds variable length text of up to 4,092 characters

Maximum length of a WIDENOTE column can be set

Indexes and constraints are allowed on WIDENOTE data types

R:BASE reserves a minimum of four bytes of internal storage space, with 2 bytes per character

 

WIDETEXT

Holds Unicode data

The default length is eight characters

The maximum is 1,500 characters

Maximum length of a WIDETEXT column can be set

R:BASE reserves a minimum of four bytes of internal storage space, with 2 bytes per character