+---------------------------------+
|             FILTER              |
+---------------------------------+
FILTER([<expN> | <expC>])

-----------------------------------
Returns filter expression specified by SET FILTER.
Return value - Character
-----------------------------------

The null string is returned if no filter is in effect.  The filter
expression returned by FILTER() is specified with the SET FILTER
command.

<expN> | <expC>
        Work area number or alias.  If <expr> is omitted, the current work area
is assumed.

+---------------------------------+
|         Program Example         |
+---------------------------------+
CLOSE ALL
SELECT 0
USE customer

SET FILTER TO !EMPTY(comments)
?FILTER()

STORE FILTER('customer') TO savefilt  && Save filter expression
SET FILTER TO state = 'OH'
?FILTER()

SET FILTER TO &savefilt  && Restore filter
?FILTER()

-----------------------------------

See Also:  SET FILTER

-----------------------------------