
SetProp()
*********


FUNKTION
========

   public mixed SetProp(string name, mixed Value);


DEFINIERT IN
============

   /std/thing/properties.c
   /sys/thing/properties.h (Prototyp)


ARGUMENTE
=========

   name       - Property, deren Wert veraendert werden soll.
   Value      - Wert, auf den der Inhalt der Property gesetzt werden soll


BESCHREIBUNG
============

   Der Datenwert der Property 'name' wird auf den Wert 'Value' gesetzt.

   Existiert eine F_SET_METHOD oder eine _set_'name'()-Methode fuer
   diese Property, so wird diese aufgerufen und ihr 'Value' uebergeben.
   Eine F_SET_METHOD hat dabei Vorrang vor _set_'name'(), d.h.
   _set_'name'() wird nach erfolgreicher F_QUERY_METHOD nicht mehr
   gerufen.

   (Diese Methoden nutzen dann Set(), um den Datenwert der Property
    'name' zu aendern. Teilweise werden aber auch interne Variablen so
    oeffentlich gemacht und sind nicht in der ueber Set/Query verfuegbaren
    Property 'name' abgelegt.)


RUeCKGABEWERT
=============

   Der Wert, der nun in der Property gespeichert ist.
   In der Regel ist das 'Value'. Wenn die Property ueber eine SET_METHOD
   oder eine _set_'name'()-Funktion verfuegt und diese 'Value' aendert
   (zum Beispiel, indem sie 'Value' an einen bestimmten erlaubten
   Wertebereich anpasst), kann der Rueckgabewert jedoch auch veraendert
   sein.

   Wenn die Property nicht veraendert werden darf, wird -1 zurueckgegeben.


BEISPIELE
=========

   // geben wir dem Zwerg eine Kurzbeschreibung
   SetProp(P_SHORT, "Ein kleiner Zwerg");


SIEHE AUCH
==========

   Aehnliches:        QueryProp(L), Set(L), Query(L)
   Generell:          SetProperties(L), QueryProperties(L)
   Konzept:           properties, /std/thing/properties.c

15.Dez 2004 Gloinson