Xbasic

BETWEEN_RECORD Function

Syntax

Filter_Expression as C = between_record(N record1 ,N record2 )

Arguments

Filter_Expression

A character filter expression that evaluates to a logical value and selects records from a table.

record1

The number of the first record in a range in the current table. Numeric

record2

The number of the last record in a range in the current table. Numeric

Description

Creates a string using the Between() function to search for a range of records numbers.

Discussion

BETWEEN_RECORD() returns a character filter expression that uses the two record number values and selects records from the table. This function is only useful in Xbasic scripts. First_Record and Last_Record are number variables. They are the first and last records in a range of records to find. Frequently in Xbasic scripts, you need to specify a filter expression in quotes. It can get quite tricky to do this if your Start and End values are stored in variables.

Example

For example, the following code fragment shows how to specify a filter expression for an Xbasic query:

dim shared First as N 
 dim shared Last as N

t = tbl.open("customer") 
 query.filter = "between_record(" + "\"" + First + "\", " + "\"" + Last + "\")" 
 t.query_create()

query.filter ? between_record("5", "15"), assuming First = 5 and Last = 15

See Also