From f00a75b860f280adad013c75b3ba1f5abcbdb870 Mon Sep 17 00:00:00 2001 From: lacatoire Date: Thu, 22 Oct 2026 10:35:37 +0200 Subject: [PATCH] [Sync-En] mbstring: document the ValueError for an invalid encoding on more pages --- .../mbstring/functions/mb-check-encoding.xml | 16 +++++++---- reference/mbstring/functions/mb-chr.xml | 8 +++++- .../mbstring/functions/mb-convert-case.xml | 8 +++++- .../mbstring/functions/mb-convert-kana.xml | 10 ++++--- .../functions/mb-decode-numericentity.xml | 4 ++- .../functions/mb-encode-numericentity.xml | 4 ++- .../mbstring/functions/mb-http-output.xml | 4 ++- reference/mbstring/functions/mb-ord.xml | 16 +++++++---- .../functions/mb-preferred-mime-name.xml | 28 +++++++++++++++++-- .../mbstring/functions/mb-regex-encoding.xml | 8 +++++- reference/mbstring/functions/mb-scrub.xml | 8 +++++- reference/mbstring/functions/mb-str-split.xml | 8 +++++- reference/mbstring/functions/mb-strcut.xml | 14 +++++++--- .../mbstring/functions/mb-strimwidth.xml | 8 +++++- reference/mbstring/functions/mb-stripos.xml | 10 ++++--- reference/mbstring/functions/mb-stristr.xml | 18 ++++++++---- reference/mbstring/functions/mb-strpos.xml | 4 ++- reference/mbstring/functions/mb-strrchr.xml | 8 +++++- reference/mbstring/functions/mb-strrichr.xml | 12 ++++++-- reference/mbstring/functions/mb-strripos.xml | 12 ++++---- reference/mbstring/functions/mb-strrpos.xml | 4 ++- reference/mbstring/functions/mb-strstr.xml | 8 +++++- .../mbstring/functions/mb-strtolower.xml | 8 +++++- .../mbstring/functions/mb-strtoupper.xml | 24 +++++++++++++++- reference/mbstring/functions/mb-strwidth.xml | 12 ++++++-- .../mbstring/functions/mb-substr-count.xml | 8 +++++- reference/mbstring/functions/mb-substr.xml | 8 +++++- 27 files changed, 221 insertions(+), 59 deletions(-) diff --git a/reference/mbstring/functions/mb-check-encoding.xml b/reference/mbstring/functions/mb-check-encoding.xml index a8dfdd8965..9354638ac7 100644 --- a/reference/mbstring/functions/mb-check-encoding.xml +++ b/reference/mbstring/functions/mb-check-encoding.xml @@ -1,11 +1,11 @@ - + mb_check_encoding - Verifica si las cadenas son válidas para el encodage especificado + Verifica si las cadenas son válidas para el codificación especificada @@ -16,9 +16,9 @@ stringnullencoding&null; - Verifica si el flujo de octetos es válido para el encodage específico. + Verifica si el flujo de octetos es válido para la codificación especificada. Si value es de tipo &array;, todas las claves y los valores son validados de manera recursiva. - Es útil para prever lo que se conoce como « ataque por encodage inválido ». + Es útil para prever lo que se conoce como « ataque por codificación inválida ». @@ -46,7 +46,7 @@ encoding - Encodage esperado. + Codificación esperada. @@ -61,6 +61,11 @@ + + &reftitle.errors; + &mbstring.errors.encoding-invalid; + + &reftitle.changelog; @@ -84,6 +89,7 @@ value y encoding ahora son nullable. + &mbstring.changelog.encoding-invalid; 7.2.0 diff --git a/reference/mbstring/functions/mb-chr.xml b/reference/mbstring/functions/mb-chr.xml index 58eb4d897f..5819f15ae2 100644 --- a/reference/mbstring/functions/mb-chr.xml +++ b/reference/mbstring/functions/mb-chr.xml @@ -1,6 +1,6 @@ - + @@ -53,6 +53,11 @@ + + &reftitle.errors; + &mbstring.errors.encoding-invalid; + + &reftitle.changelog; @@ -65,6 +70,7 @@ &mbstring.changelog.encoding-nullable; + &mbstring.changelog.encoding-invalid; diff --git a/reference/mbstring/functions/mb-convert-case.xml b/reference/mbstring/functions/mb-convert-case.xml index 1483058635..ee03d9f044 100644 --- a/reference/mbstring/functions/mb-convert-case.xml +++ b/reference/mbstring/functions/mb-convert-case.xml @@ -1,6 +1,6 @@ - + @@ -68,6 +68,11 @@ + + &reftitle.errors; + &mbstring.errors.encoding-invalid; + + &reftitle.changelog; @@ -90,6 +95,7 @@ MB_CASE_TITLE_SIMPLE. + &mbstring.changelog.encoding-invalid; 7.3.0 diff --git a/reference/mbstring/functions/mb-convert-kana.xml b/reference/mbstring/functions/mb-convert-kana.xml index 71a5d3c8de..cb7c342b2e 100644 --- a/reference/mbstring/functions/mb-convert-kana.xml +++ b/reference/mbstring/functions/mb-convert-kana.xml @@ -1,6 +1,6 @@ - + @@ -85,7 +85,7 @@ A - Convierte los números y alfabeto "zen-kaku" en "han-kaku". + Convierte los números y alfabeto "han-kaku" en "zen-kaku". (Los caracteres incluidos en las opciones "a", "A" son U+0021 - U+007E excluyendo U+0022, U+0027, U+005C, U+007E) @@ -93,13 +93,13 @@ s - Convierte "zen-kaku" en "han-kaku" (U+3000 -> U+0020) + Convierte el espacio "zen-kaku" en "han-kaku" (U+3000 -> U+0020) S - Convierte "han-kaku" en "zen-kaku" (U+0020 -> U+3000) + Convierte el espacio "han-kaku" en "zen-kaku" (U+0020 -> U+3000) @@ -174,6 +174,7 @@ diferentes mode no es válida. Por ejemplo "sS". + &mbstring.errors.encoding-invalid; @@ -195,6 +196,7 @@ &mbstring.changelog.encoding-nullable; + &mbstring.changelog.encoding-invalid; diff --git a/reference/mbstring/functions/mb-decode-numericentity.xml b/reference/mbstring/functions/mb-decode-numericentity.xml index b26f0d1bdf..6964ccc2b1 100644 --- a/reference/mbstring/functions/mb-decode-numericentity.xml +++ b/reference/mbstring/functions/mb-decode-numericentity.xml @@ -1,5 +1,5 @@ - + @@ -66,6 +66,7 @@ map contiene algún valor que no sea un &integer;, un &float;, un &boolean;, &null; o una cadena numérica. + &mbstring.errors.encoding-invalid; @@ -88,6 +89,7 @@ &mbstring.changelog.encoding-nullable; + &mbstring.changelog.encoding-invalid; diff --git a/reference/mbstring/functions/mb-encode-numericentity.xml b/reference/mbstring/functions/mb-encode-numericentity.xml index 70676d9e3e..fbd1bba7b2 100644 --- a/reference/mbstring/functions/mb-encode-numericentity.xml +++ b/reference/mbstring/functions/mb-encode-numericentity.xml @@ -1,5 +1,5 @@ - + @@ -77,6 +77,7 @@ map contiene algún valor que no sea un &integer;, un &float;, un &boolean;, &null; o una cadena numérica. + &mbstring.errors.encoding-invalid; @@ -99,6 +100,7 @@ &mbstring.changelog.encoding-nullable; + &mbstring.changelog.encoding-invalid; diff --git a/reference/mbstring/functions/mb-http-output.xml b/reference/mbstring/functions/mb-http-output.xml index d23f66ec23..9a95694061 100644 --- a/reference/mbstring/functions/mb-http-output.xml +++ b/reference/mbstring/functions/mb-http-output.xml @@ -1,6 +1,6 @@ - + @@ -60,6 +60,7 @@ Levanta una excepción ValueError si encoding contiene octetos nulos. + &mbstring.errors.encoding-invalid; @@ -82,6 +83,7 @@ &mbstring.changelog.encoding-nullable; + &mbstring.changelog.encoding-invalid; diff --git a/reference/mbstring/functions/mb-ord.xml b/reference/mbstring/functions/mb-ord.xml index 91757aae6e..34dd42945d 100644 --- a/reference/mbstring/functions/mb-ord.xml +++ b/reference/mbstring/functions/mb-ord.xml @@ -1,5 +1,5 @@ - + @@ -49,6 +49,11 @@ + + &reftitle.errors; + &mbstring.errors.encoding-invalid; + + &reftitle.changelog; @@ -61,6 +66,7 @@ &mbstring.changelog.encoding-nullable; + &mbstring.changelog.encoding-invalid; @@ -83,10 +89,10 @@ var_dump(mb_ord("\x80", "Windows-1252")); &example.outputs; - int(65) - int(128024) - int(128) - int(8364) +int(65) +int(128024) +int(128) +int(8364) diff --git a/reference/mbstring/functions/mb-preferred-mime-name.xml b/reference/mbstring/functions/mb-preferred-mime-name.xml index da7f02d259..73f32694ce 100644 --- a/reference/mbstring/functions/mb-preferred-mime-name.xml +++ b/reference/mbstring/functions/mb-preferred-mime-name.xml @@ -1,11 +1,11 @@ - + mb_preferred_mime_name - Detecta la codificación MIME + Obtiene la cadena del juego de caracteres MIME @@ -15,7 +15,7 @@ stringencoding - Obtiene el nombre de la codificación MIME de una cadena. + Obtiene la cadena del juego de caracteres MIME para una codificación específica. @@ -43,6 +43,28 @@ + + &reftitle.errors; + &mbstring.errors.encoding-invalid; + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &mbstring.changelog.encoding-invalid; + + + + + &reftitle.examples; diff --git a/reference/mbstring/functions/mb-regex-encoding.xml b/reference/mbstring/functions/mb-regex-encoding.xml index 600640003f..5a1e6be25a 100644 --- a/reference/mbstring/functions/mb-regex-encoding.xml +++ b/reference/mbstring/functions/mb-regex-encoding.xml @@ -1,6 +1,6 @@ - + @@ -47,6 +47,11 @@ + + &reftitle.errors; + &mbstring.errors.encoding-invalid; + + &reftitle.changelog; @@ -60,6 +65,7 @@ &mbstring.changelog.encoding-nullable; + &mbstring.changelog.encoding-invalid; diff --git a/reference/mbstring/functions/mb-scrub.xml b/reference/mbstring/functions/mb-scrub.xml index 300f9d97f5..4f5d594bc7 100644 --- a/reference/mbstring/functions/mb-scrub.xml +++ b/reference/mbstring/functions/mb-scrub.xml @@ -1,6 +1,6 @@ - + mb_scrub @@ -54,6 +54,11 @@ + + &reftitle.errors; + &mbstring.errors.encoding-invalid; + + &reftitle.changelog; @@ -66,6 +71,7 @@ &mbstring.changelog.encoding-nullable; + &mbstring.changelog.encoding-invalid; diff --git a/reference/mbstring/functions/mb-str-split.xml b/reference/mbstring/functions/mb-str-split.xml index 315e9580b8..3343377714 100644 --- a/reference/mbstring/functions/mb-str-split.xml +++ b/reference/mbstring/functions/mb-str-split.xml @@ -1,5 +1,5 @@ - + @@ -65,6 +65,11 @@ + + &reftitle.errors; + &mbstring.errors.encoding-invalid; + + &reftitle.changelog; @@ -77,6 +82,7 @@ &mbstring.changelog.encoding-nullable; + &mbstring.changelog.encoding-invalid; 8.0.0 diff --git a/reference/mbstring/functions/mb-strcut.xml b/reference/mbstring/functions/mb-strcut.xml index 6b09bea686..7fd78eaa10 100644 --- a/reference/mbstring/functions/mb-strcut.xml +++ b/reference/mbstring/functions/mb-strcut.xml @@ -1,6 +1,6 @@ - + @@ -95,12 +95,17 @@ &reftitle.returnvalues; mb_strcut devuelve la porción del string - string que comienza en el carácter - start y tiene la longitud de - length caracteres. + string especificada por los argumentos + start y + length. + + &reftitle.errors; + &mbstring.errors.encoding-invalid; + + &reftitle.changelog; @@ -119,6 +124,7 @@ &mbstring.changelog.encoding-nullable; + &mbstring.changelog.encoding-invalid; diff --git a/reference/mbstring/functions/mb-strimwidth.xml b/reference/mbstring/functions/mb-strimwidth.xml index d6ef42fb25..28df2e66b5 100644 --- a/reference/mbstring/functions/mb-strimwidth.xml +++ b/reference/mbstring/functions/mb-strimwidth.xml @@ -1,5 +1,5 @@ - + @@ -89,6 +89,11 @@ + + &reftitle.errors; + &mbstring.errors.encoding-invalid; + + &reftitle.changelog; @@ -108,6 +113,7 @@ &mbstring.changelog.encoding-nullable; + &mbstring.changelog.encoding-invalid; 7.1.0 diff --git a/reference/mbstring/functions/mb-stripos.xml b/reference/mbstring/functions/mb-stripos.xml index 0451b23e7e..5dbb5a0787 100644 --- a/reference/mbstring/functions/mb-stripos.xml +++ b/reference/mbstring/functions/mb-stripos.xml @@ -1,11 +1,11 @@ - + mb_stripos - Encuentra la primera ocurrencia de una cadena en otra, sin tener en cuenta la casilla + Encuentra la primera ocurrencia de una cadena en otra, sin distinguir mayúsculas de minúsculas &reftitle.description; @@ -16,14 +16,14 @@ intoffset0 stringnullencoding&null; - + mb_stripos devuelve la posición numérica de la primera ocurrencia de needle en la cadena haystack. A diferencia de mb_strpos, mb_stripos no distingue entre mayúsculas y minúsculas. Si needle no es encontrado, la función devolverá &false;. - + &reftitle.parameters; @@ -85,6 +85,7 @@ + &mbstring.errors.encoding-invalid; @@ -100,6 +101,7 @@ &mbstring.changelog.needle-empty; &mbstring.changelog.encoding-nullable; + &mbstring.changelog.encoding-invalid; 7.1.0 diff --git a/reference/mbstring/functions/mb-stristr.xml b/reference/mbstring/functions/mb-stristr.xml index 78784ffd17..7106734ede 100644 --- a/reference/mbstring/functions/mb-stristr.xml +++ b/reference/mbstring/functions/mb-stristr.xml @@ -1,11 +1,11 @@ - + mb_stristr - Encuentra la primera ocurrencia de una cadena en otra, sin tener en cuenta la casilla + Encuentra la primera ocurrencia de una cadena en otra, sin distinguir mayúsculas de minúsculas &reftitle.description; @@ -16,14 +16,14 @@ boolbefore_needle&false; stringnullencoding&null; - + mb_stristr encuentra la primera ocurrencia de needle en haystack y devuelve la porción de haystack. A diferencia de mb_strstr, mb_stristr no distingue entre mayúsculas y minúsculas. Si needle no se encuentra, la función devolverá &false;. - + &reftitle.parameters; @@ -49,7 +49,7 @@ before_needle - + Determina qué porción de haystack devuelve esta función. Si se establece en &true;, la función devolverá toda la cadena haystack @@ -58,7 +58,7 @@ Si se establece en &false;, la función devolverá toda la cadena haystack desde la primera ocurrencia de needle hasta el final (needle incluido). - + @@ -78,6 +78,11 @@ + + &reftitle.errors; + &mbstring.errors.encoding-invalid; + + &reftitle.changelog; @@ -91,6 +96,7 @@ &mbstring.changelog.needle-empty; &mbstring.changelog.encoding-nullable; + &mbstring.changelog.encoding-invalid; diff --git a/reference/mbstring/functions/mb-strpos.xml b/reference/mbstring/functions/mb-strpos.xml index 1d4c60b3c6..33a6bffc0e 100644 --- a/reference/mbstring/functions/mb-strpos.xml +++ b/reference/mbstring/functions/mb-strpos.xml @@ -1,6 +1,6 @@ - + @@ -93,6 +93,7 @@ + &mbstring.errors.encoding-invalid; @@ -108,6 +109,7 @@ &mbstring.changelog.needle-empty; &mbstring.changelog.encoding-nullable; + &mbstring.changelog.encoding-invalid; 7.1.0 diff --git a/reference/mbstring/functions/mb-strrchr.xml b/reference/mbstring/functions/mb-strrchr.xml index 381afcb2a8..93d4f39a14 100644 --- a/reference/mbstring/functions/mb-strrchr.xml +++ b/reference/mbstring/functions/mb-strrchr.xml @@ -1,6 +1,6 @@ - + @@ -75,6 +75,11 @@ + + &reftitle.errors; + &mbstring.errors.encoding-invalid; + + &reftitle.changelog; @@ -88,6 +93,7 @@ &mbstring.changelog.needle-empty; &mbstring.changelog.encoding-nullable; + &mbstring.changelog.encoding-invalid; diff --git a/reference/mbstring/functions/mb-strrichr.xml b/reference/mbstring/functions/mb-strrichr.xml index da381c98a1..54136b7716 100644 --- a/reference/mbstring/functions/mb-strrichr.xml +++ b/reference/mbstring/functions/mb-strrichr.xml @@ -1,6 +1,6 @@ - + @@ -49,14 +49,14 @@ before_needle - + Determina qué porción de haystack devuelve esta función. Si se establece en &true;, la función devuelve toda la cadena haystack desde el principio hasta la última ocurrencia de needle. Si se establece en &false;, la función devuelve toda la cadena haystack desde la última ocurrencia de needle hasta el final. - + @@ -77,6 +77,11 @@ + + &reftitle.errors; + &mbstring.errors.encoding-invalid; + + &reftitle.changelog; @@ -90,6 +95,7 @@ &mbstring.changelog.needle-empty; &mbstring.changelog.encoding-nullable; + &mbstring.changelog.encoding-invalid; diff --git a/reference/mbstring/functions/mb-strripos.xml b/reference/mbstring/functions/mb-strripos.xml index 1447919f6d..a094223f66 100644 --- a/reference/mbstring/functions/mb-strripos.xml +++ b/reference/mbstring/functions/mb-strripos.xml @@ -1,11 +1,11 @@ - + mb_strripos - Encuentra la posición de la última ocurrencia de una cadena en otra, sin tener en cuenta la casilla + Encuentra la posición de la última ocurrencia de una cadena en otra, sin distinguir mayúsculas de minúsculas &reftitle.description; @@ -16,15 +16,15 @@ intoffset0 stringnullencoding&null; - + mb_strripos realiza una operación strripos basada en el número de caracteres. La posición needle se cuenta desde el inicio de haystack. La posición del primer carácter es 0. El segundo tiene como posición 1, etc. A diferencia de mb_strrpos, - mb_strripos no es sensible a la casilla. - + mb_strripos no distingue entre mayúsculas y minúsculas. + &reftitle.parameters; @@ -88,6 +88,7 @@ + &mbstring.errors.encoding-invalid; @@ -103,6 +104,7 @@ &mbstring.changelog.needle-empty; &mbstring.changelog.encoding-nullable; + &mbstring.changelog.encoding-invalid; diff --git a/reference/mbstring/functions/mb-strrpos.xml b/reference/mbstring/functions/mb-strrpos.xml index cd04d1e376..ff93cdc757 100644 --- a/reference/mbstring/functions/mb-strrpos.xml +++ b/reference/mbstring/functions/mb-strrpos.xml @@ -1,6 +1,6 @@ - + @@ -88,6 +88,7 @@ + &mbstring.errors.encoding-invalid; @@ -110,6 +111,7 @@ &mbstring.changelog.encoding-nullable; + &mbstring.changelog.encoding-invalid; diff --git a/reference/mbstring/functions/mb-strstr.xml b/reference/mbstring/functions/mb-strstr.xml index 362096cf49..3b3c2b0901 100644 --- a/reference/mbstring/functions/mb-strstr.xml +++ b/reference/mbstring/functions/mb-strstr.xml @@ -1,5 +1,5 @@ - + mb_strstr @@ -75,6 +75,11 @@ + + &reftitle.errors; + &mbstring.errors.encoding-invalid; + + &reftitle.changelog; @@ -99,6 +104,7 @@ &mbstring.changelog.needle-empty; &mbstring.changelog.encoding-nullable; + &mbstring.changelog.encoding-invalid; diff --git a/reference/mbstring/functions/mb-strtolower.xml b/reference/mbstring/functions/mb-strtolower.xml index ad28f1864c..75c2898141 100644 --- a/reference/mbstring/functions/mb-strtolower.xml +++ b/reference/mbstring/functions/mb-strtolower.xml @@ -1,6 +1,6 @@ - + @@ -51,6 +51,11 @@ + + &reftitle.errors; + &mbstring.errors.encoding-invalid; + + &reftitle.changelog; @@ -69,6 +74,7 @@ Implementación de reglas de conversión condicional a minúsculas para la letra griega sigma. + &mbstring.changelog.encoding-invalid; diff --git a/reference/mbstring/functions/mb-strtoupper.xml b/reference/mbstring/functions/mb-strtoupper.xml index e43a7e9176..371cc6820b 100644 --- a/reference/mbstring/functions/mb-strtoupper.xml +++ b/reference/mbstring/functions/mb-strtoupper.xml @@ -1,6 +1,6 @@ - + @@ -51,6 +51,28 @@ + + &reftitle.errors; + &mbstring.errors.encoding-invalid; + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &mbstring.changelog.encoding-invalid; + + + + + &reftitle.examples; diff --git a/reference/mbstring/functions/mb-strwidth.xml b/reference/mbstring/functions/mb-strwidth.xml index a6dc2d25c9..743462f586 100644 --- a/reference/mbstring/functions/mb-strwidth.xml +++ b/reference/mbstring/functions/mb-strwidth.xml @@ -1,11 +1,11 @@ - + mb_strwidth - Devuelve el tamaño de una cadena + Devuelve la anchura de una cadena @@ -92,10 +92,15 @@ &reftitle.returnvalues; - El tamaño de la string string. + La anchura de la string string. + + &reftitle.errors; + &mbstring.errors.encoding-invalid; + + &reftitle.changelog; @@ -108,6 +113,7 @@ &mbstring.changelog.encoding-nullable; + &mbstring.changelog.encoding-invalid; diff --git a/reference/mbstring/functions/mb-substr-count.xml b/reference/mbstring/functions/mb-substr-count.xml index 06a99003bb..9851618590 100644 --- a/reference/mbstring/functions/mb-substr-count.xml +++ b/reference/mbstring/functions/mb-substr-count.xml @@ -1,6 +1,6 @@ - + @@ -63,6 +63,11 @@ + + &reftitle.errors; + &mbstring.errors.encoding-invalid; + + &reftitle.changelog; @@ -75,6 +80,7 @@ &mbstring.changelog.encoding-nullable; + &mbstring.changelog.encoding-invalid; diff --git a/reference/mbstring/functions/mb-substr.xml b/reference/mbstring/functions/mb-substr.xml index 79ea716835..fe24fe3dd7 100644 --- a/reference/mbstring/functions/mb-substr.xml +++ b/reference/mbstring/functions/mb-substr.xml @@ -1,5 +1,5 @@ - + mb_substr @@ -86,6 +86,11 @@ + + &reftitle.errors; + &mbstring.errors.encoding-invalid; + + &reftitle.changelog; @@ -112,6 +117,7 @@ &mbstring.changelog.encoding-nullable; + &mbstring.changelog.encoding-invalid;