diff --git a/reference/intl/idn/idn-to-ascii.xml b/reference/intl/idn/idn-to-ascii.xml new file mode 100644 index 000000000..3a9c9dd9c --- /dev/null +++ b/reference/intl/idn/idn-to-ascii.xml @@ -0,0 +1,201 @@ + + + + + idn_to_ascii + Wandelt einen Domainnamen in die IDNA-ASCII-Form um + + + &reftitle.description; + &style.procedural; + + stringfalseidn_to_ascii + stringdomain + intflagsIDNA_DEFAULT + intvariantINTL_IDNA_VARIANT_UTS46 + arrayidna_info&null; + + + Diese Funktion wandelt einen Unicode-Domainnamen in ein + IDNA-ASCII-kompatibles Format in Kleinbuchstaben um. + + + + + &reftitle.parameters; + + + + domain + + + Die umzuwandelnde Domain, die UTF-8-kodiert sein muss. + + + + + flags + + + Umwandlungsoptionen - eine Kombination der IDNA_*-Konstanten + (außer den IDNA_ERROR_*-Konstanten). + + + + + variant + + + Entweder INTL_IDNA_VARIANT_2003 (veraltet seit + PHP 7.2.0) für IDNA 2003 oder + INTL_IDNA_VARIANT_UTS46 (erst ab ICU 4.6 + verfügbar) für UTS #46. + + + + + idna_info + + + Dieser Parameter kann nur verwendet werden, wenn + INTL_IDNA_VARIANT_UTS46 für + variant verwendet wurde. In diesem Fall wird er + mit einem Array gefüllt, das die Schlüssel 'result' + (das möglicherweise unzulässige Ergebnis der Umwandlung), + 'isTransitionalDifferent' (ein boolescher Wert, der + angibt, ob die Verwendung der Übergangsmechanismen von UTS #46 das + Ergebnis verändert hat oder verändert hätte) und + 'errors' (ein int, der einen Bitsatz + der Fehlerkonstanten IDNA_ERROR_* darstellt) enthält. + + + + + + + + + &reftitle.returnvalues; + + Der in ASCII-kompatibler Form kodierte Domainname, &return.falseforfailure; + + + + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + + 8.4.0 + + Wirft nun einen ValueError, wenn der + Parameter domain leer ist. + + + + 8.4.0 + + Wirft nun einen ValueError, wenn der + Parameter variant nicht + INTL_IDNA_VARIANT_UTS46 ist. + + + + 7.4.0 + + Der Standardwert von variant ist nun + INTL_IDNA_VARIANT_UTS46 anstelle des veralteten + INTL_IDNA_VARIANT_2003. + + + + 7.2.0 + + INTL_IDNA_VARIANT_2003 wurde als veraltet + markiert; INTL_IDNA_VARIANT_UTS46 sollte + stattdessen verwendet werden. + + + + + + + + + + &reftitle.examples; + + <function>idn_to_ascii</function>-Beispiel + + +]]> + + + &example.outputs; + + + + + Reine ASCII-Domainnamen werden nur in Kleinbuchstaben umgewandelt + + +]]> + + + &example.outputs; + + + + + + + &reftitle.seealso; + + + idn_to_utf8 + + + + + diff --git a/reference/intl/idn/idn-to-utf8.xml b/reference/intl/idn/idn-to-utf8.xml new file mode 100644 index 000000000..8d625aa8b --- /dev/null +++ b/reference/intl/idn/idn-to-utf8.xml @@ -0,0 +1,183 @@ + + + + + idn_to_utf8 + Wandelt einen Domainnamen von IDNA-ASCII nach Unicode um + + + &reftitle.description; + &style.procedural; + + stringfalseidn_to_utf8 + stringdomain + intflagsIDNA_DEFAULT + intvariantINTL_IDNA_VARIANT_UTS46 + arrayidna_info&null; + + + Diese Funktion wandelt einen Unicode-Domainnamen aus einem + IDNA-ASCII-kompatiblen Format in reines Unicode um, kodiert in UTF-8. + + + + + &reftitle.parameters; + + + + domain + + + Die umzuwandelnde Domain in einem IDNA-ASCII-kompatiblen Format. + + + + + flags + + + Umwandlungsoptionen - eine Kombination der IDNA_*-Konstanten + (außer den IDNA_ERROR_*-Konstanten). + + + + + variant + + + Entweder INTL_IDNA_VARIANT_2003 (veraltet seit + PHP 7.2.0) für IDNA 2003 oder + INTL_IDNA_VARIANT_UTS46 (erst ab ICU 4.6 + verfügbar) für UTS #46. + + + + + idna_info + + + Dieser Parameter kann nur verwendet werden, wenn + INTL_IDNA_VARIANT_UTS46 für + variant verwendet wurde. In diesem Fall wird er + mit einem Array gefüllt, das die Schlüssel 'result' + (das möglicherweise unzulässige Ergebnis der Umwandlung), + 'isTransitionalDifferent' (ein boolescher Wert, der + angibt, ob die Verwendung der Übergangsmechanismen von UTS #46 das + Ergebnis verändert hat oder verändert hätte) und + 'errors' (ein int, der einen Bitsatz + der Fehlerkonstanten IDNA_ERROR_* darstellt) enthält. + + + + + + + + + &reftitle.returnvalues; + + Der Domainname in Unicode, kodiert in UTF-8, &return.falseforfailure; + + + + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + + 8.4.0 + + Wirft nun einen ValueError, wenn der + Parameter domain leer ist. + + + + 8.4.0 + + Wirft nun einen ValueError, wenn der + Parameter variant nicht + INTL_IDNA_VARIANT_UTS46 ist. + + + + 7.4.0 + + Der Standardwert von variant ist nun + INTL_IDNA_VARIANT_UTS46 anstelle des veralteten + INTL_IDNA_VARIANT_2003. + + + + 7.2.0 + + INTL_IDNA_VARIANT_2003 wurde als veraltet + markiert; INTL_IDNA_VARIANT_UTS46 sollte + stattdessen verwendet werden. + + + + + + + + + + &reftitle.examples; + + <function>idn_to_utf8</function>-Beispiel + + +]]> + + + &example.outputs; + + + + + + + &reftitle.seealso; + + + idn_to_ascii + + + + + diff --git a/reference/mbstring/functions/mb-strcut.xml b/reference/mbstring/functions/mb-strcut.xml new file mode 100644 index 000000000..ffcb47f6a --- /dev/null +++ b/reference/mbstring/functions/mb-strcut.xml @@ -0,0 +1,153 @@ + + + + + mb_strcut + Gibt einen Teil einer Zeichenkette zurück + + + + &reftitle.description; + + stringmb_strcut + stringstring + intstart + intnulllength&null; + stringnullencoding&null; + + + mb_strcut extrahiert eine Teilzeichenkette aus einer + Zeichenkette, ähnlich wie mb_substr, arbeitet jedoch + mit Bytes statt mit Zeichen. Liegt die Schnittposition zwischen zwei Bytes + eines Multibyte-Zeichens, wird der Schnitt ab dem ersten Byte dieses + Zeichens vorgenommen. Das ist auch der Unterschied zur Funktion + substr, die die Zeichenkette einfach zwischen den + Bytes schneiden und so eine fehlerhafte Byte-Sequenz erzeugen würde. + + + + + &reftitle.parameters; + + + + string + + + Die zu schneidende Zeichenkette. + + + + + start + + + Ist start nicht negativ, beginnt die + zurückgegebene Zeichenkette an der start-ten + Byte-Position in string, + von null an gezählt. In der Zeichenkette 'abcdef' + ist beispielsweise das Byte an Position 0 + 'a', das Byte an Position 2 + 'c' und so weiter. + + + Ist start negativ, beginnt die zurückgegebene + Zeichenkette am start-ten Byte, vom Ende von + string aus rückwärts gezählt. Ist der Betrag + eines negativen start jedoch größer als die + Länge der Zeichenkette, beginnt der zurückgegebene Teil am Anfang von + string. + + + + + length + + + Länge in Bytes. Wird er weggelassen oder + NULL übergeben, werden alle Bytes bis zum Ende der + Zeichenkette extrahiert. + + + Ist length negativ, endet die zurückgegebene + Zeichenkette am length-ten Byte, vom Ende von + string aus rückwärts gezählt. Ist der Betrag + eines negativen length jedoch größer als die + Anzahl der Zeichen nach der start-Position, wird + eine leere Zeichenkette zurückgegeben. + + + + + encoding + + &mbstring.encoding.parameter; + + + + + + + + &reftitle.returnvalues; + + mb_strcut gibt den durch die Parameter + start und length angegebenen + Teil von string zurück. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.4.0 + + Das Verhalten ist nun bei ungültigen UTF-8- und UTF-16-Zeichenketten konsistenter. + + + &mbstring.changelog.encoding-nullable; + + + + + + + &reftitle.seealso; + + + mb_substr + mb_internal_encoding + + + + + + diff --git a/reference/mbstring/functions/mb-substr.xml b/reference/mbstring/functions/mb-substr.xml new file mode 100644 index 000000000..7a0ec8695 --- /dev/null +++ b/reference/mbstring/functions/mb-substr.xml @@ -0,0 +1,142 @@ + + + + + mb_substr + Gibt einen Teil einer Zeichenkette zurück + + + + &reftitle.description; + + stringmb_substr + stringstring + intstart + intnulllength&null; + stringnullencoding&null; + + + Führt eine Multibyte-sichere substr-Operation auf + Basis der Anzahl der Zeichen durch. Die Position wird vom Anfang von + string an gezählt. Die Position des ersten Zeichens + ist 0, die des zweiten Zeichens 1 und so weiter. + + + + + &reftitle.parameters; + + + + string + + + Die Zeichenkette, aus der die Teilzeichenkette extrahiert werden soll. + + + + + start + + + Ist start nicht negativ, beginnt die + zurückgegebene Zeichenkette an der start-ten + Position in string, von null an gezählt. In der + Zeichenkette 'abcdef' ist beispielsweise das Zeichen + an Position 0 'a', das Zeichen an + Position 2 'c' und so weiter. + + + Ist start negativ, beginnt die zurückgegebene + Zeichenkette am start-ten Zeichen vom Ende von + string aus. + + + + + length + + + Maximale Anzahl der aus string zu verwendenden + Zeichen. Wird er weggelassen oder NULL übergeben, + werden alle Zeichen bis zum Ende der Zeichenkette extrahiert. + + + + + encoding + + &mbstring.encoding.parameter; + + + + + + + + &reftitle.returnvalues; + + mb_substr gibt den durch die Parameter + start und length angegebenen + Teil von string zurück. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.4.0 + + Bei ungültigen Zeichenketten (solchen mit Kodierungsfehlern) werden + Zeichenindizes nun auf dieselbe Weise interpretiert wie bei den meisten + anderen mbstring-Funktionen. Das bedeutet, dass von + mb_strpos zurückgegebene Zeichenindizes direkt + übergeben werden können. + + + &mbstring.changelog.encoding-nullable; + + + + + + + &reftitle.seealso; + + + mb_strcut + mb_internal_encoding + + + + + +