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

DELETE TAG           Delete a tag from an index file
------------------------------------------------------------------------------

Synopsis

    DELETE TAG <cTag> [IN <cBag>]

Arguments

    <cTag> is the tag to be deleted.

    <cBag> is optional, and if provided specifies the index file from which
    <cTag> is to be deleted.

Description

    The DELETE TAG command 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.

    DELETE TAG 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 first tag tag1
    index on last tag tag2
    index on age tag tag1 to age

    ? ordName(1), ordKey(1)         && tag1, first
    ? ordName(2), ordKey(2)         && tag2, last
    ? ordName(3), ordKey(3)         && tag1, age

    delete tag tag1
    ? ordName(1), ordKey(1)         && tag2, last
    ? ordName(2), ordKey(2)         && tag1, age

    delete tag tag1 in age          && AGE.CDX is closed & deleted (since
                                    && it now has 0 indexes in it)
    ? ordName(1), ordKey(1)         && tag2, last
    ? ordName(2), ordKey(2)         && Both empty strings
    
See Also

    ordDestroy()