doc/lfun/int_long

int_long()
FUNKTION:
     varargs string int_long(mixed viewer, mixed viewpoint, int flags)

DEFINIERT IN:
     /std/room/description.c

ARGUMENTE:
     mixed viewer	- der Betrachter des Raumes
     mixed viewpoint	- 0/Objekt/Array der/die Ausgangspunkt(e) des
			  Betrachtens (und damit nicht sichtbar!)
     int flags		- Modifikatoren fuer die Anzeige
			  (siehe "man make_invlist", wird mit 3 verUNDet!)

BESCHREIBUNG:
     Es wird die Beschreibung des Rauminneren erstellt. Dabei wird die
     Langbeschreibung des Raumes, die enthaltenen Objekte (exklusive
     aller viewpoints (normalerweise nur der Betrachter)) und Ausgaenge,
     wenn vom Viewer eingeschaltet dargestellt.
     Falls der Raum innerhalb eines anderen Raumes liegt und selbst
     transparent ist, wie zusaetzlich die Kurzbeschreibung des Aussen-
     raumes angezeigt.

     Ist Viewer ein Magier mit eingeschaltetem Magiermodus, so wird der
     Beschreibung der Dateiname des Raumes vorangestellt.

RUeCKGABEWERT:
     Die Langbeschreibung des Raumes von innen.

BEMERKUNGEN:
     Die Trennung von viewer und viewpoint hat durchaus ihren Sinn. So ist
     es zum Beispiel moeglich, einen Raum "mit den Augen eines Anderen" zu
     betrachten. Dabei saehe man sich selbst, wenn man im Raum waere.

BEISPIELE:
     // in diesem Raum sieht man keine Mitspieler im "schau" oder beim
     // Betreten (vielleicht ist es zu neblig)
     // dazu werden einfach alle Interactives zu den viewpoints addiert
     string int_long(object viewer, mixed viewpoints, int flags) {
      if(!pointerp(viewpoints)) viewpoints=({viewpoints});
      return ::int_long(&viewer,
			viewpoints+
			filter(all_inventory(this_object()),
				     #'interactive),
			&flags);
     }

     string int_short(object viewer, mixed viewpoints) {
      if(!pointerp(viewpoints)) viewpoints=({viewpoints});
      return ::int_short(&viewer,
			 viewpoints+
			 filter(all_inventory(this_object()),
				      #'interactive));
     }

SIEHE AUCH:
     Aehnliches:	int_short()
     Properties:	P_INT_LONG, P_SHORT
			P_HIDE_EXITS, P_SHOW_EXITS
			P_TRANSPARENT
     Kommandokette:	make_invlist(), short()
     Sonstiges:		P_REFERENCE_OBJECT, P_WANTS_TO_LEARN

11. Mai 2004 Gloinson