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

ordDestroy()          Delete an index from an index file
------------------------------------------------------------------------------

Synopsis

    ordDestroy( cTag [, cBag] ) -> NIL

Arguments

    cTag is a character string containing the name of the tag to be
    deleted.

    cBag is optionally the name of the specific .CDX from which the tag is
    to be deleted.

Returns

    NIL.

Description

    The ordDestroy() function causes a tag to be removed from a currently
    open .CDX.  All indexes after the deleted index slide back by 1.  If the
    master index is deleted, the order is set to 0.

    If the number of tags in a .CDX reaches 0, the .CDX is automatically
    closed and deleted from disk.

    ordDestroy() does _not_ free any space from the .CDX.

    A REINDEX (or deleting the .CDX and recreating all tags) will reclaim
    the space which was used by the tag.

Example

    use demo
    index on last tag last
    index on first tag first
    ? cmxCount()                    && Returns 2
    ordDestroy("last")
    ? cmxTagCount()                 && Returns 1

See Also

    DELETE TAG