storing data in the player (Lynx, Oct 8 1991, 28) | Documentation bulletin board | bulletin boards

           A
          / \      _             Play Now                         Nemesis on 
          | |     | |  _______   _        _   _______    _______   _    _______
          | |\    | | |   ____| |  \    /  | |   ____|  /   ____| | |  /   ____|
 /-------/-------------------------------------------------------------------,
O= Home <=XX|  About  News  Pics  Adventurers  Wizards  Download  Connect     >
 \-------\-------------------------------------------------------------------'
          | |   \   | |  |____  | |      | | |  |____   ___ \  \  | |  ___ \  \
          | |     \_| |_______| |_|      |_| |_______| |_______/  |_| |_______/
          \ /
           V

Nemesis bulletin boards: Documentation bulletin board, note 10

storing data in the player (Lynx, Oct 8 1991, 28)

How to store your data in the player data file:
==============================================
I have implemented a system that lets each object store one string
in the player data file by passing the string to the player.c
By each object the file name is meant, so you can only store a
string for each program, not for each clone.
The advantage of this system compared to auto_load is, that auto_load
data gets lost if the object is not loadable, this data is kept
unless it is removed by the object itself, or by a game master.

Usage:
=====
STORING:	this_player()->store_data(my_data);

my_data is a string that holds important info that you want to keep
safe in the player data file. store_data returns 1 if successful,
(should always be that way), and it overwrites old data, if data
was in storage before. If no data is passed, the call is ignored, the
data stays unchanged.

RETRIEVING:	my_data = this_player()->query_data();

No arguments. The string is retrieved that your object has stored
some time ago, could even be months! So beware not to change your
format or to keep track of it! Returns 0 if no data could be found.

REMOVING:	[ my_data = ]	this_player()->remove_data();

This call lets you clean up after yourself. Remove your data from
the storage completely. Returns 0 if there was no data in storage
or returns the last kept data if successful.

*** This was brought to you by the Internet lynx of ChatLand! ***
	Mail lynx@ChatLand for questions.

This board is to document how to code various stuff in Nemesis.
Within Nemesis it is located in the inner guild in the village.
If you have written documents that should be placed here or
if you think something important is missing please contact an
Archwizard - see 'help admin' or https://nemesis.de/lpc/help/admin .
Nowadays especially new features etc. are posted here.
The board contains 49 notes:

This page was generated in LPC

Imprint / Impressum