===== cpGetStrafkatalog =====

==== Einleitung ====
\\
 Dieser Befehl fragt die aktuell einem Fahrer zugewiesenen Strafpunkte aus dem Strafkatalog ab. In Kombination mit [[cockpit-xp:addon:befehlsreferenz:cpSetstrafkatalog|cpSetStrafkatalog]] lässt sich auch addieren.
\\
 
==== Syntax ====

^  Befehl | cpGetStrafkatalog(Fahrername:String) |
^  Funktion| Fragt den aktuellen Punktestand für einen Fahrer aus dem internen Strafkatalog ab. |
^  Typ | Integer |

==== Codebeispiel =====

<Code:pascal linenums>var
  slot : Integer;
  sFahrerName : String;
  strafPunkte1 : Integer;
  strafPunkte2 : Integer;
  msg : String;
  mitStrafe : Boolean;
  
begin

  // Variablen initialisieren
  msg := '';
  
  // Fahrernamen speichern
  sFahrerName := 'slot-xtreme';
  
  // Mit Bestrafung bei Erreichen Punktelimit
  // abhängig vom Fahrernamen :-)
  if sFahrerName = 'Ralph525' then
    mitStrafe := True
  else
    mitStrafe := False;

  // Strafpunkte vergeben
  cpSetStrafkatalog(sFahrerName, 2);
  
  // Aktuellen Punktestand abfragen
  strafPunkte1 := cpGetStrafkatalog(sFahrerName);
  
  // Meldung erweitern
  msg := msg + 'Fahrer ' + sFahrerName +  ' - ';
  msg := msg + IntToStr(strafPunkte1) + ' Punkte';
  msg := msg + Chr(13) + Chr(10);
  
  // Fahrer bekommt weitere Punkte und ggfs. Strafe
  cpAddStrafkatalog(sFahrerName, 11, mitStrafe);

  // Neuen Punktestand abfragen
  strafPunkte2 := cpGetStrafkatalog(sFahrerName);
  
  // Meldung erweitern
  msg := msg + 'Fahrer ' + sFahrerName +  ' - ';
  msg := msg + IntToStr(strafPunkte2) + ' Punkte';
  msg := msg + Chr(13) + Chr(10);
  
  cpShowMessage(msg);

end.</Code> 
\\
 Zeigt die folgende Meldung. Mit [[cockpit-xp:addon:befehlsreferenz:cpsetstrafkatalog|cpSetStrafkatalog]] erhält der Fahrer erst einmal 2 Strafpunkte. Der Punktestand wird fest gesetzt. Sollte der Fahrer z.B. 5 Punkte auf dem Konto haben, ist der Kontostand nachher 2 Punkte!

Der Befehl [[cockpit-xp:addon:befehlsreferenz:cpgetstrafkatalog|cpGetStrafkatalog]] fragt den aktuellen Punktestand ab. Möchte man mit [[cockpit-xp:addon:befehlsreferenz:cpsetstrafkatalog|cpSetStrafkatalog]] Punkte addieren, müsste man im ersten Schritt den Punktestand abfragen, anschließend Strafpunkte addieren und dann den errechneten neuen Wert setzen.

Einfacher ist das per [[cockpit-xp:addon:befehlsreferenz:cpaddstrafkatalog|cpAddStrafkatalog]] möglich, da dieser Befehl Punkte zum aktuellen Stand addiert. 
\\ 
{{ :cockpit-xp:addon:befehlsreferenz:cpwiki-cpget-set-add-strafkatalog.png?nolink |}}
\\ 
=== Hinweis ===
Derzeit ist noch ein Fehler im Befehl [[cockpit-xp:addon:befehlsreferenz:cpaddstrafkatalog|cpAddStrafkatalog]]. Er funktioniert nur wie erwartet, wenn ''BestrafungStrafkatalog'' auf **False** gesetzt ist. Mit **True** erfolgt **KEINE** Bestrafung und auch **KEINE** Addition der Punkte.

{{ :cockpit-xp:addon:befehlsreferenz:cpwiki-cpaddstrafkatalog-bug.png?nolink |}}
\\ 

----

[[cockpit-xp:start|Start]] - [[cockpit-xp:faq|FAQ]] - [[cockpit-xp:glossar|Glossar]] - [[cockpit-xp:sitemap|Sitemap]] - [[cockpit-xp:impressum|Impressum]]