Signatur
Beschreibung
hebrevc() ist eine Erweiterung der Funktion hebrev() und konvertiert hebräischen Text, der in logischer Zeichenreihenfolge (wie er im Computer gespeichert ist) vorliegt, in die visuelle Rechts-nach-Links-Darstellung. Im Unterschied zu hebrev() ersetzt hebrevc() dabei zusätzlich alle vorkommenden Zeilenumbrüche (\n) durch HTML-Zeilenumbrüche (<br>\n).
Der optionale Parameter max_chars_per_line ermöglicht eine automatische Zeilenumbruch-Steuerung: Die Funktion versucht, die Zeilen auf maximal die angegebene Zeichenanzahl zu begrenzen und bricht dabei möglichst an Wortgrenzen um. Ein Wert von 0 (Standard) deaktiviert diese Begrenzung.
Diese Funktion ist besonders nützlich, wenn hebräischer Text in älteren Systemen oder Umgebungen ohne native Unicode-Bidi-Unterstützung dargestellt werden muss. In modernen Webanwendungen empfiehlt sich stattdessen die Verwendung von Unicode und CSS-Eigenschaft direction: rtl gemeinsam mit dem dir-HTML-Attribut.
Achtung: Die Funktion wurde in PHP 8.0 als deprecated markiert und sollte in neuen Projekten nicht mehr verwendet werden.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $hebrew_text Pflicht | string | Der hebräische Eingabetext in logischer Zeichenreihenfolge (ISO-8859-8-kodiert). | |
| $max_chars_per_line | int | 0 | Maximale Anzahl von Zeichen pro Zeile. Bei 0 wird kein automatischer Zeilenumbruch durchgeführt. |
Rückgabewert
\n-Zeilenumbrüche durch <br>\n ersetzt wurden.Beispiele
Einfache Konvertierung mit Zeilenumbruch
<?php
// Hebräischer Text (ISO-8859-8) mit Zeilenumbruch
$hebrew = "\xf9\xec\xe5\xed\n\xe4\xe9\xe9\n\xe2\xf0\xe1\xf8"; // Beispielstring
$visual = hebrevc($hebrew);
echo $visual;
// Zeilenumbrüche im Eingabetext werden in <br>\n umgewandeltKonvertierung mit maximaler Zeilenlänge
<?php
// Langer hebräischer Text, begrenzt auf 40 Zeichen pro Zeile
$hebrew = "\xf9\xec\xe5\xed \xe4\xe5\xe0 \xee\xe5\xf9\xe2 \xe4\xe1\xf8\xe9\xfa \xf9\xec\xe5\xed \xe4\xe5\xe0";
$visual = hebrevc($hebrew, 40);
echo $visual;
// Ausgabe wird auf max. 40 Zeichen je Zeile begrenzt, Umbrüche als <br>// Wichtig · Fallstricke
Deprecated seit PHP 8.0: hebrevc() ist seit PHP 8.0 als veraltet markiert und wird in einer zukünftigen PHP-Version entfernt. Für neue Projekte sollte stattdessen auf Unicode (UTF-8) mit dem HTML-Attribut dir="rtl" oder der CSS-Eigenschaft direction: rtl gesetzt werden, um arabische und hebräische Texte korrekt darzustellen.
Die Funktion arbeitet ausschließlich mit ISO-8859-8-kodierten Strings. Bei UTF-8-kodierten Eingaben liefert sie keine korrekten Ergebnisse.
Wenn nur die Bidi-Konvertierung ohne Ersetzung von Zeilenumbrüchen benötigt wird, sollte stattdessen hebrev() verwendet werden.