Returns the current setting of a SET...TO command or function key.

Syntax

SETTO(<expC> [,<expN>])

<expC>

A character expression that is the SET...TO command whose setting value to return.

<expN>

The nth such setting to return.

Description

Use SETTO( ) to get a SET or function key setting so that you can change it or save it. For example, you can issue SETTO( ) at the beginning of a routine to get current settings. You can then save these settings in memory variables, change the settings, and restore the original settings from the memory variables at the end of the routine.

When dBASE Plus supports a SET and a SET...TO command that use the same keyword, SET( ) returns the SET setting and SETTO( ) returns the SET...TO setting. For example, you can issue SET FIELDS ON, SET FIELDS OFF, or SET FIELDS TO <field list>. SET("FIELDS") returns the ON or OFF setting and SETTO("FIELDS") returns the field list as a character expression.

SETTO( ) is almost identical to SET( ). For more information, see SET( ).