Click above to get retro games delivered to your door ever month!

cmxCustom()           Get/set Custom Built Index flag for an index
------------------------------------------------------------------------------

Synopsis

    cmxCustom( [nOrder | cTag [, cBag [, lCustom]]] ) -> lPrevCustom

Arguments

    nOrder, cTag and cBag are optional parameters which specify the index.
    If omitted or NIL, the current master index will be used.

    nOrder is the numeric order of the index.

    cTag is the tag of the index, and cBag is the specific index file in
    which to find cTag.

    lCustom is optional, and if specified is the new custom built setting
    for the index (NOTE: This conversion is one-way;  you can change a
    regular index to a Custom Built Index, but you can never change a Custom
    Built Index to a regular index).

Returns

    cmxCustom() returns the previous setting of the custom built flag.

Description

    cmxCustom() converts a regular index to a Custom Built Index.

    This allows you to create an initial set of keys for a Custom Built
    Index using the standard INDEX command and then convert it to a Custom
    Built Index (so you can make custom additions/deletions using
    cmxKeyAdd() & cmxKeyDel()).

Example

    use demo

    index on last to last for age = 30  && Initially just look at 30's

    cmxCustom(nil, nil, .t.)            && Now we have a Custom Built Index

    goto 100
    cmxKeyAdd()                         && Add record 100 to the index

See Also

    cmxFor(), cmxKeyAdd(), cmxKeyDel()