Functions and Directives Functions and Directives

Function DbSetScope() Foundation

Sets scope values for logical or physical orders.

Syntax
DbSetScope( <nScope>, <xValue> ) --> NIL
Parameters
<nScope>
A #define constant listed in STD.CH must be used for <nScope>.
Constants for scopes
Constant Description
SCOPE_BOTH Specifies top and bottom scope.
SCOPE_BOTTOM Specifies the bottom scope
SCOPE_TOP Specifies the top scope
<xValue>
This parameter defines the value for the scope specified with <nScope>. When SCOPE_BOTH is passed for <nScope>, <xValue> is used for the top and bottom scope.
<xValue> must have the same data type as the index key or must be a numeric specifying a record number when no controlling index is active.
Return

The return value of DbSetScope() is always NIL.

Description

A scope is used to quickly specify a range of records in a database. Only those records whose scope values lie within the range of the top and bottom scope values are visible. Refer to SET SCOPE for a detailed explanation about scopes.

Feedback

If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.