wStringconverter::checkUTF8

Prüft, ob eine Zeichenkette UTF-8 konform ist

Funktionsaufruf

String checkUTF8(String str)

Parameter

str
Zu prüfende Zeichenkette

Prüft, ob die Zeichenkette UTF-8 konform ist und kodiert diese gegebenenfalls

  include($_SERVER['DOCUMENT_ROOT'].'/weblication/grid.php');
  
  $str    = "Deutsche Umlaute: ä, ö, ü";
  $strIso = utf8_decode($str);
  
  print "String UTF-8 kodiert: ".$str;
  print "<br />String ISO-8859-1 kodiert: ".$strIso;
  
  if(!wStringconverter::checkUTF8($strIso)){
    $strutf8 = wStringconverter::toUTF8($strIso);
  }
  
  print "<br />ISO-8859-1 String in UTF-8 konvertiert: ".$strutf8;

Hinweis
Beim Einsatz von Framework-Funktionen in eigenen Skripten beachten Sie bitte den Artikel "So verwenden Sie das PHP-Framework in eigenen Scripten".
Wenn Sie eine Funktion innerhalb einer Weblication® Seite z.B. über das PHP-Quelltext Element oder in einem XSL-Template über wsl:php einbinden, muss das Framework über die grid.php nicht mehr referenziert werden.

 
FAQs
Was macht wStringconverter::checkUTF8?
wStringconverter::checkUTF8 prüft, ob eine Zeichenkette UTF-8 konform ist. Ist die Zeichenkette nicht korrekt UTF-8 kodiert, wird im Beispiel anschließend eine Umkodierung auf UTF-8 vorgenommen.
Wie wird die Funktion wStringconverter::checkUTF8 aufgerufen?
Der Funktionsaufruf lautet: <code class="codeInline">String checkUTF8(String str)</code>.
Welcher Parameter wird an checkUTF8 übergeben?
<code class="codeInline">str</code> ist die zu prüfende Zeichenkette, deren UTF-8-Konformität geprüft werden soll.
Was zeigt das Beispiel zur Nutzung der UTF-8-Prüfung?
Im Beispiel wird eine Zeichenkette zunächst (scheinbar) in eine ISO-8859-1-Variante über <code class="codeInline">utf8_decode</code> umkodiert und dann geprüft: Wenn <code class="codeInline">wStringconverter::checkUTF8($strIso)</code> fehlschlägt, wird die Zeichenkette mit <code class="codeInline">wStringconverter::toUTF8($strIso)</code> nach UTF-8 konvertiert.
Wann wird im Beispiel eine Konvertierung zu UTF-8 durchgeführt?
Eine Konvertierung zu UTF-8 wird dann durchgeführt, wenn <code class="codeInline">wStringconverter::checkUTF8($strIso)</code> **nicht** bestanden wird (d.h. im Beispiel innerhalb von <code class="codeInline">if(!wStringconverter::checkUTF8($strIso))</code>).
Muss in eigenen Skripten die grid.php eingebunden werden?
Im Beispiel wird vor der Nutzung <code class="codeInline">include($_SERVER['DOCUMENT_ROOT'].'/weblication/grid.php');</code> verwendet. Der Hinweis sagt jedoch: Wenn Sie eine Funktion innerhalb einer Weblication®-Seite einbinden (z.B. über das PHP-Quelltext Element oder in einem XSL-Template über <code class="codeInline">wsl:php</code>), muss das Framework über <code class="codeInline">grid.php</code> nicht mehr referenziert werden.