FUNKTION:
int AddFuel( int f );
ARGUMENTE:
f: Anzahl in Sekunden, die zur Brennzeit hinzugenommen
werden soll, also Brennstoff.
BESCHREIBUNG:
Gibt wiederaufladbaren Brennquellen die Moeglichkeit, ihre
Brennzeit aufzufuellen. Dabei entspricht 'f' dem Wert in
Sekunden, die der aktuell noch verbleibenden Brennzeit
hinzugefuegt werden sollen. Dabei wird P_MAX_FUEL als max.
Brenndauer nicht ueberschritten.
RÜCKGABEWERT:
Der Wert an Brennzeit, der nicht mehr hineingepasst hat.
0 wenn die Brennzeit hinzugefuegt werden konnte, ohne dabei
die max. Brennzeit P_MAX_FUEL zu ueberschreiten. Positiver
Wert, der nicht mehr in das Objekt passte. -1 fuer
fehlerhaftes Argument.
BEISPIEL:
int ;
i = this_object()->AddFuel(2000);
// fuellt dem Objekt Brennstoff fuer 2000 Sekunden nach;
// hat nicht alles in das Objekt gepasst, steht der nicht
// mehr passende Wert in i
SIEHE AUCH:
P_FUEL, P_MAX_FUEL
|