[an error occurred while processing this directive]
[<a href="index.shtml">Package Index</a></code> | <a href="index_std.shtml">Mudlib Index</a></code> | <a href="index_eff.shtml">Effect Index</a></code>]<br><h2>File /obj/handlers/item_tracker.c</h2>
This handler keeps track of unique (hopefully) per player items in the game.<p>Written by Shaggy
<h2>Inherits</h2>
This class inherits the following classes /std/object.c<h2>Includes</h2>
This class includes the following files /include/quest_handler.h and /include/library.h<h2>Method index</h2>
<ul>
<li><a href="#delete_item">delete_item</a>(mixed, mixed)<br/>
This method deletes the state/location information of a specific quest item
owned by a player.
<li><a href="#query_all_item_states">query_all_item_states</a>(mixed)<br/>
This method returns all the information about quest items
owned by a player.
<li><a href="#query_item_copies">query_item_copies</a>(mixed, mixed)<br/>
This method returns the total number of known copies of a specific quest item
owned by a player.
<li><a href="#query_item_state">query_item_state</a>(mixed, mixed)<br/>
This method returns the state/location of a specific quest item
owned by a player.
<li><a href="#save_all_item_states">save_all_item_states</a>(mixed)<br/>
This method saves the mapping of state/location 
information for items owned by a player to disk.
<li><a href="#save_all_item_states_delete_cache">save_all_item_states_delete_cache</a>(mixed)<br/>
This method saves the mapping of state/location 
information for items owned by a player to disk and deletes
the entry in the cache.
<li><a href="#set_item_state">set_item_state</a>(mixed, mixed, mixed)<br/>
This method sets the state/location of a specific quest item
owned by a player.
</ul>
<h2>Public Functions</h2>
These are functions that everyone can access.<p>
<dl>
<dt class="autodocfuncname"><a name="delete_item">
delete_item</a><pre class="autodocfuncdef">
int delete_item(mixed pl_name,
                mixed item)
</pre><dd><br />
This method deletes the state/location information of a specific quest item
owned by a player.
<p>
If the item isn't actually owned by the player it returns 0<br />
<br /><dl>
<dd><b>Parameters:</b><br />
pl_name -   player object or name<br />
item -      item object or identifier<br />
<br />
<dd><b>See also:</b>
<br /><a href="#set_item_state">set_item_state()
</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="query_all_item_states">
query_all_item_states</a><pre class="autodocfuncdef">
mixed query_all_item_states(mixed pl_name)
</pre><dd><br />
This method returns all the information about quest items
owned by a player.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
pl_name -   player object or name<br />
<br />
<dd><b>See also:</b>
<br /><a href="#set_item_state">set_item_state()</a> and <a href="#delete_item">delete_item()
</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="query_item_copies">
query_item_copies</a><pre class="autodocfuncdef">
int query_item_copies(mixed pl_name,
                      mixed item)
</pre><dd><br />
This method returns the total number of known copies of a specific quest item
owned by a player.
<p>
If the item isn't actually owned by the player it doesn't matter.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
pl_name -   player object or name<br />
item -      item object or identifier<br />
<br />
<dd><b>See also:</b>
<br /><a href="#set_item_state">set_item_state()</a> and <a href="#delete_item">delete_item()
</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="query_item_state">
query_item_state</a><pre class="autodocfuncdef">
mixed query_item_state(mixed pl_name,
                       mixed item)
</pre><dd><br />
This method returns the state/location of a specific quest item
owned by a player.
<p>
If the item isn't actually owned by the player it returns 0<br />
<br /><dl>
<dd><b>Parameters:</b><br />
pl_name -   player object or name<br />
item -      item object or identifier<br />
<br />
<dd><b>See also:</b>
<br /><a href="#set_item_state">set_item_state()</a> and <a href="#delete_item">delete_item()
</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="save_all_item_states">
save_all_item_states</a><pre class="autodocfuncdef">
int save_all_item_states(mixed pl_name)
</pre><dd><br />
This method saves the mapping of state/location 
information for items owned by a player to disk.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
pl_name -   player object or name<br />
item -      item object or identifier<br />
<br />
<dd><b>Returns:</b>
<br />1 if successful<br /><br />
<dd><b>See also:</b>
<br /><a href="#set_item_state">set_item_state()</a>, <a href="#query_item_state">query_item_state()</a>, <a href="#delete_item">delete_item()</a> and <a href="#save_all_item_states_and_delete_from_cache">save_all_item_states_and_delete_from_cache()
</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="save_all_item_states_delete_cache">
save_all_item_states_delete_cache</a><pre class="autodocfuncdef">
int save_all_item_states_delete_cache(mixed pl_name)
</pre><dd><br />
This method saves the mapping of state/location 
information for items owned by a player to disk and deletes
the entry in the cache.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
pl_name -   player object or name<br />
item -      item object or identifier<br />
<br />
<dd><b>Returns:</b>
<br />1 if successful<br /><br />
<dd><b>See also:</b>
<br /><a href="#set_item_state">set_item_state()</a>, <a href="#query_item_state">query_item_state()</a>, <a href="#delete_item">delete_item()</a> and <a href="#save_all_item_states">save_all_item_states()
</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="set_item_state">
set_item_state</a><pre class="autodocfuncdef">
int set_item_state(mixed pl_name,
                   mixed item,
                   mixed state)
</pre><dd><br />
This method sets the state/location of a specific quest item
owned by a player.
<p>
If the item isn't actually owned by the player it returns 0<br />
<br /><dl>
<dd><b>Parameters:</b><br />
pl_name -   player object or name<br />
item -      item object or identifier<br />
<br />
<dd><b>See also:</b>
<br /><a href="#query_item_state">query_item_state()</a>, <a href="#delete_item">delete_item()</a> and <a href="#save_all_item_states">save_all_item_states()
</a><br /><br /><br /></dl>

</dl>
[an error occurred while processing this directive]