@find [<name>] [= <flags/types> = [<output type>]]
Searches through the database for items that you control matching <name>.
Players control only objects they own; wizards control all objects, so @find
searches the entire database when they use it. Because the command is
computationally expensive, this costs 100 pennies.
Flags or types can be specified, to specify that you only want to list objects
that have that flag set, or that are of that type. You can also specify to
list objects that are NOT of that specific type, or that do NOT have that flag.
(A "!" before the modifier indicates that it is to be inverted.)
The flags that you can specify are: (use the initial capitalized letter only)
Abode, Builder/Block, Chown_ok, Dark/Debug, Haven, Interactive, Jump_ok,
Kill_ok, Link_ok, Mucker, Quell, Sticky/Silent, Vehicle, Wizard, Xforcible,
and Zombie.
You can also specify Mucker Levels by the level number: 1, 2, 3, or 4.
The types that you can specify are: (use the capitalized letter only)
Exit, muF program, Garbage, Player, Room, and Thing.
There are a few other modifiers you can specify: (use only initial character)
- Unlinked
- will specify that you want to list only unlinked objects.
- @
- specifies to list objects longer than about 90 days old.
- ~size
- will match all objs whose current memory usage is greater than or equal to size bytes. This must be the last modifier in the list of modifiers.
- ^size
- will match all objs whose total memory usage, when fully loaded, is greater than size bytes. To do this, it loads the entire object into memory from disk. This modifier is only available to wizards. For regular players, this acts like ~size. This must be the last modifier in the list of modifiers.
The output types that can be given are owners, links, size, count, & location.
(You use the whole name for output type, and you can use only one at a time.)
- owners
- lists who owns each object.
- links
- shows what each object is linked to, or *UNLINKED*, or, for exits linked to multiple things, *METALINK*
- size
- displays how much memory is currently being used by an object. If this option is used with the ^ modifier, (see above) then this will display the true full size of the object, and not just how much is currently being used.
- count
- causes nothing to be shown but how many objects the @find/etc would match. ie: it doesn't display any of the matched objects.
- location
- shows where the object is located at.
The matching on names is as follows:
- Individual words can be matched as {word1|word2|...}
- Individual characters can be matched as [abc...]
- A ? matches any character.
- A * matches any number of characters, including none.
- Any of these special charcters can be matched by putting a \ before it.
Examples of use:
- @find north = EU = location
- will find all of your unlinked exits named "north" and print them along with their locations.
- @find {big|little} = R!L
- finds all your rooms whose names contain "big" or "little" and are not LINK_OK.
- @find w[ei]ll
- will find everything you control whose name contains "will" or "well."
- @find =E=links
- will list all exits that you control, and display where they are linked to.
- @find button==locations
- will list all objects you control with 'button' in the name, and it will display where thay are located at.
- @find =~2000=size
- will list all your objects whose current memory usage is 2000 bytes or more, and it will display their size.
- @find =^2000=size
- will, for a wizard, find all objects in the db that are 2000 or more bytes in total size, when fully loaded, and it will show their sizes. Note that this will load all of each object into memory to make the size determination. On some systems this can take a while, and on all systems this is an abuse to the diskbasing cache. Only Wizards may use this search feature.
See also @OWNED, @ENTRANCES, @CONTENTS