De/CHandle: Difference between revisions
< De
Jump to navigation
Jump to search
(Created page with '{{otherlang2 |en=CHandle }} {{toc-right}} '''CHandle''' ist eine C++ Klasse, die eine eindeutige 32-Bit ID (entindex + serial number) für jede vergangene und kommende Entity im…') |
Biohazard 90 (talk | contribs) m (language...) |
||
| Line 4: | Line 4: | ||
{{toc-right}} | {{toc-right}} | ||
'''CHandle''' ist eine C++ Klasse, die eine eindeutige 32-Bit ID (entindex + serial number) für jede | '''CHandle''' ist eine C++ Klasse, die eine eindeutige 32-Bit ID (entindex + serial number) für jede entfernte und neu erstellte Entity im Spiel darstellt. Es wird verwendet, um auf Entities zu verweisen, wo [[pointer:de|Pointer]] und [[entity index:de|Entity Indizes]] unsicher sind; hauptsächlich über die Client-/Server-Kluft und nach dem Laden eines Spielstandes. | ||
{{tip:de|Zugriffe auf CHandles sind langsamer | {{tip:de|Zugriffe auf CHandles sind langsamer als Zugriffe auf Pointer. Wenn man Pointer zu Zugriffszwecken erzeugt und sie Spielstände unterstützen sollen, muss man sie über <code>[[Restore()]]</code> neu definieren!}} | ||
== Gebrauch == | == Gebrauch == | ||
| Line 12: | Line 12: | ||
CHandle<YourStoredClass> hMyHandle; | CHandle<YourStoredClass> hMyHandle; | ||
Ein CHandle ist den Pointern sehr ähnlich, aber weil es eine maßgeschneiderte C++ Klasse ist und kein | Ein CHandle ist den Pointern sehr ähnlich, aber weil es eine maßgeschneiderte C++ Klasse ist und kein built-in Feature, ist eine besondere Syntax an manchen Stellen notwendig: | ||
* Man muss einen Pointer zum Objekt anbinden, nicht das Objekt selbst. | * Man muss einen Pointer zum Objekt anbinden, nicht das Objekt selbst. | ||
* Des <code>CHandle</code>s <code>Get()</code> Funktion oder ein Cast ist erforderlich, um auf die gespeicherte Klasse zuzugreifen. | * Des <code>CHandle</code>s <code>Get()</code> Funktion oder ein Cast ist erforderlich, um auf die gespeicherte Klasse zuzugreifen. | ||
* <code>IsValid()</code> wird benutzt, um zu überprüfen, ob ein Wert gespeichert wird. | * <code>IsValid()</code> wird benutzt, um zu überprüfen, ob ein Wert gespeichert wird. | ||
* | * Um ein <code>CHandle</code> ungültig zu machen, muss <code>Term()</code> aufgerufen oder <code>INVALID_EHANDLE_INDEX</code> zugeordnet werden. | ||
== EHANDLE == | == EHANDLE == | ||
CHandle wird häufig durch das <code>EHANDLE</code> typedef | CHandle wird häufig durch das <code>EHANDLE</code> typedef benutzt, welches die Kurzform für <code>CHandle<C_BaseEntity></code> ist. Wenn man eine bestimmte Klasse speichern will, ist es besser, einen spezifischeren CHandle manuell zu deklarieren (siehe vorheriger Abschnitt). | ||
== Beispiel == | == Beispiel == | ||
| Line 28: | Line 28: | ||
CBasePlayer* pPlayer = gEntList.FindEntityByClassname( NULL, "player" ); | CBasePlayer* pPlayer = gEntList.FindEntityByClassname( NULL, "player" ); | ||
// speichere es(zwei Mal, zu Demonstrationszwecken) | // speichere es (zwei Mal, zu Demonstrationszwecken) | ||
EHANDLE hPlayer = pPlayer; | EHANDLE hPlayer = pPlayer; | ||
CHandle<CBasePlayer> hPlayer_ = pPlayer; | CHandle<CBasePlayer> hPlayer_ = pPlayer; | ||
Revision as of 06:39, 24 May 2011
CHandle ist eine C++ Klasse, die eine eindeutige 32-Bit ID (entindex + serial number) für jede entfernte und neu erstellte Entity im Spiel darstellt. Es wird verwendet, um auf Entities zu verweisen, wo Pointer und Entity Indizes unsicher sind; hauptsächlich über die Client-/Server-Kluft und nach dem Laden eines Spielstandes.
Gebrauch
CHandle<YourStoredClass> hMyHandle;
Ein CHandle ist den Pointern sehr ähnlich, aber weil es eine maßgeschneiderte C++ Klasse ist und kein built-in Feature, ist eine besondere Syntax an manchen Stellen notwendig:
- Man muss einen Pointer zum Objekt anbinden, nicht das Objekt selbst.
- Des
CHandlesGet()Funktion oder ein Cast ist erforderlich, um auf die gespeicherte Klasse zuzugreifen. IsValid()wird benutzt, um zu überprüfen, ob ein Wert gespeichert wird.- Um ein
CHandleungültig zu machen, mussTerm()aufgerufen oderINVALID_EHANDLE_INDEXzugeordnet werden.
EHANDLE
CHandle wird häufig durch das EHANDLE typedef benutzt, welches die Kurzform für CHandle<C_BaseEntity> ist. Wenn man eine bestimmte Klasse speichern will, ist es besser, einen spezifischeren CHandle manuell zu deklarieren (siehe vorheriger Abschnitt).
Beispiel
// Erzeuge einen Pointer auf eine Entity
CBasePlayer* pPlayer = gEntList.FindEntityByClassname( NULL, "player" );
// speichere es (zwei Mal, zu Demonstrationszwecken)
EHANDLE hPlayer = pPlayer;
CHandle<CBasePlayer> hPlayer_ = pPlayer;
// konvertiere das EHANDLE zurück in einen CBasePlayer-Pointer
pPlayer = dynamic_cast<CBasePlayer*>( hPlayer.Get() );