Nove: XML import

2025-12-04T22:34:54Z

XML import

Nove: XML import

2020-05-27T13:08:04Z

XML import

New page

'''Function:''' store( u : unitptr , filename : string , container : integer );

 '''u'''
 The Unit that has the contents to be stored or is to be stored
 '''filename'''
 The name of the file you want to store the Units to
 '''container'''
 Do you want to save the container 'TRUE' for yes, 'False' for no

Store saves a copy of a unit or units. If the container value is 'TRUE'
everything inside including the container itself will be saved. If the container
argument is 'FALSE' only the contents of the object will be saved. You will want
to use the 'TRUE' value when saving something like a Clan chest that has items
inside to store and has extras on the chest that you also wish to keep. The
'FALSE' value for container would be good for temporary storage of PC inventory
or for storing room contents.

The 'store' and 'restore' are perfect for operations such as
mud mailing objects from player to player, storage devices for players that will
keep inventory through a reboot. Even the ability to save a players inventory
while they fight in an arena and restore it to them undamaged when finished.
Finally it could be used to save a donation room through reboots since it can be
used on a room to store the contents of a room any NPC or objects in the room
would be saved through reboot.

'''Disk access is always slow'''.
If you use store on a continues basis, it is essential that you do so ONLY if it
is needed and even then, only at amply spaced intervals. Otherwise you might
cause serious delays on the server. Remember that items saved in player's
inventories are automatically saved in their instance.
'''Example 1:'''

---~---~---~---~---~---~---~---~---

dilbegin save_contents ();
code
{

:start:
wait (SFB_CMD,command ("store")); wait for the store command*/
block;
store("chest."+self.zoneidx,self,FALSE);/*store everything inside self.*/
goto start;
}
dilend

---~---~---~---~---~---~---~---~---


'''Example 2:'''


dilbegin save_container_n_contents ();
code
{

:start:
wait (SFB_CMD,command ("store")); wait for the store command*/
block;
store("chest."+self.zoneidx,self,TRUE);/*store everything inside self and self.*/
goto start;
}
dilend

---~---~---~---~---~---~---~---~---


'''See Also'''
[[#bfrestore|Store a Unit to a Unit file]] and
[[#bfdelunit|Delete a Unit file]].

---~---~---~---~---~---~---~---~---

@@ Line 1: / Line 1: @@
 <span id="bpstore"></span>
@@ Line 42: / Line 102: @@
   dilbegin save_contents ();
   code
 dilend
   ---~---~---~---~---~---~---~---~---
@@ Line 61: / Line 113: @@
   dilbegin save_container_n_contents ();
   code
 dilend
   ---~---~---~---~---~---~---~---~---

Manual:DIL Manual/store() - Revision history

Nove: XML import

Nove: XML import