From d278d0a6334852044a8650b57669b9c86d9bf6e4 Mon Sep 17 00:00:00 2001 From: lacatoire Date: Sat, 24 Oct 2026 08:53:19 +0200 Subject: [PATCH] [Sync-En] Document ValueError for stream, count, dirname, php_uname, gettext, extract, array_multisort, base_convert, log and enchant_broker_* --- reference/array/functions/array-multisort.xml | 21 ++++++++++- reference/array/functions/count.xml | 18 +++++++++- reference/array/functions/extract.xml | 36 ++++++++++++++++++- .../functions/enchant-broker-describe.xml | 9 +++-- .../functions/enchant-broker-dict-exists.xml | 18 +++++++++- .../functions/enchant-broker-free-dict.xml | 7 +++- .../enchant/functions/enchant-broker-free.xml | 11 +++++- .../functions/enchant-broker-get-error.xml | 7 +++- .../enchant/functions/enchant-broker-init.xml | 5 +-- .../functions/enchant-broker-list-dicts.xml | 7 +++- .../functions/enchant-broker-request-dict.xml | 14 ++++++-- .../enchant-broker-request-pwl-dict.xml | 10 ++++-- .../functions/enchant-broker-set-ordering.xml | 18 +++++++++- reference/filesystem/functions/dirname.xml | 34 +++++++++++++++++- reference/gettext/functions/dgettext.xml | 20 ++++++++--- reference/gettext/functions/dngettext.xml | 18 ++++++++-- reference/info/functions/php-uname.xml | 14 ++++++-- reference/math/functions/base-convert.xml | 18 +++++++++- reference/math/functions/log.xml | 34 +++++++++++++++++- .../stream/functions/stream-get-contents.xml | 16 ++++++++- .../stream/functions/stream-get-line.xml | 32 ++++++++++++++++- .../functions/stream-socket-enable-crypto.xml | 19 +++++++++- .../functions/stream-socket-recvfrom.xml | 32 ++++++++++++++++- .../functions/stream-socket-shutdown.xml | 34 +++++++++++++++++- 24 files changed, 418 insertions(+), 34 deletions(-) diff --git a/reference/array/functions/array-multisort.xml b/reference/array/functions/array-multisort.xml index fe7489ae2e..626dd6b425 100644 --- a/reference/array/functions/array-multisort.xml +++ b/reference/array/functions/array-multisort.xml @@ -1,5 +1,5 @@ - + @@ -125,6 +125,18 @@ + + &reftitle.errors; + + Lanza una ValueError si se proporciona un indicador de ordenación desconocido, o si + los arrays no tienen todos el mismo tamaño. + + + Lanza una TypeError si un argumento no es ni un array + ni un indicador de ordenación, o si se proporciona dos veces un indicador de ordenación del mismo tipo para un mismo array. + + + &reftitle.changelog; @@ -142,6 +154,13 @@ El tipo de retorno es ahora &true;; anteriormente, era bool. + + 8.0.0 + + Ahora lanza una ValueError o una TypeError para argumentos inválidos. + Anteriormente, se emitía una E_WARNING y se devolvía &false;. + + diff --git a/reference/array/functions/count.xml b/reference/array/functions/count.xml index 4c9abb6050..43f9518d62 100644 --- a/reference/array/functions/count.xml +++ b/reference/array/functions/count.xml @@ -1,5 +1,5 @@ - + @@ -69,6 +69,14 @@ + + &reftitle.errors; + + Lanza una ValueError si mode + no es COUNT_NORMAL ni COUNT_RECURSIVE. + + + &reftitle.changelog; @@ -80,6 +88,14 @@ + + 8.0.0 + + Ahora lanza una ValueError si + mode no es COUNT_NORMAL ni + COUNT_RECURSIVE. + + 8.0.0 diff --git a/reference/array/functions/extract.xml b/reference/array/functions/extract.xml index 7cdb1d7b8b..39a8a8dd29 100644 --- a/reference/array/functions/extract.xml +++ b/reference/array/functions/extract.xml @@ -1,5 +1,5 @@ - + @@ -163,6 +163,40 @@ Devuelve el número de variables importadas con éxito a la tabla de símbolos. + + + &reftitle.errors; + + Lanza una ValueError si flags no es un tipo + de extracción válido, si no se proporciona prefix pero + flags lo necesita, o si prefix + no es un nombre de variable válido. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + Ahora lanza una ValueError para un flags + o un prefix inválido. + Anteriormente, se emitía una E_WARNING y se devolvía &null;. + + + + + + &reftitle.examples; diff --git a/reference/enchant/functions/enchant-broker-describe.xml b/reference/enchant/functions/enchant-broker-describe.xml index f26988d163..32566ff532 100644 --- a/reference/enchant/functions/enchant-broker-describe.xml +++ b/reference/enchant/functions/enchant-broker-describe.xml @@ -1,8 +1,8 @@ - + - + enchant_broker_describe Enumera los proveedores Enchant @@ -33,6 +33,11 @@ + + &reftitle.errors; + &ext.enchant.broker-valueerror; + + &reftitle.changelog; diff --git a/reference/enchant/functions/enchant-broker-dict-exists.xml b/reference/enchant/functions/enchant-broker-dict-exists.xml index 159c949caa..6035886c7f 100644 --- a/reference/enchant/functions/enchant-broker-dict-exists.xml +++ b/reference/enchant/functions/enchant-broker-dict-exists.xml @@ -1,5 +1,5 @@ - + @@ -39,6 +39,15 @@ + + &reftitle.errors; + &ext.enchant.broker-valueerror; + + Lanza una ValueError si + tag está vacío. + + + &reftitle.changelog; @@ -50,6 +59,13 @@ + + 8.5.0 + + Ahora lanza una ValueError si + tag está vacío. + + &enchant.changelog.broker-param; diff --git a/reference/enchant/functions/enchant-broker-free-dict.xml b/reference/enchant/functions/enchant-broker-free-dict.xml index ae4351c572..7fb98999f2 100644 --- a/reference/enchant/functions/enchant-broker-free-dict.xml +++ b/reference/enchant/functions/enchant-broker-free-dict.xml @@ -1,6 +1,6 @@ - + @@ -38,6 +38,11 @@ + + &reftitle.errors; + &ext.enchant.dict-valueerror; + + &reftitle.changelog; diff --git a/reference/enchant/functions/enchant-broker-free.xml b/reference/enchant/functions/enchant-broker-free.xml index 0a6a283d9a..12b93ecafd 100644 --- a/reference/enchant/functions/enchant-broker-free.xml +++ b/reference/enchant/functions/enchant-broker-free.xml @@ -1,6 +1,6 @@ - + @@ -39,6 +39,15 @@ + + &reftitle.errors; + &ext.enchant.broker-valueerror; + + Lanza una Error si + broker todavía tiene diccionarios abiertos. + + + &reftitle.changelog; diff --git a/reference/enchant/functions/enchant-broker-get-error.xml b/reference/enchant/functions/enchant-broker-get-error.xml index 5adfb9f0d0..7469212471 100644 --- a/reference/enchant/functions/enchant-broker-get-error.xml +++ b/reference/enchant/functions/enchant-broker-get-error.xml @@ -1,6 +1,6 @@ - + @@ -31,6 +31,11 @@ + + &reftitle.errors; + &ext.enchant.broker-valueerror; + + &reftitle.changelog; diff --git a/reference/enchant/functions/enchant-broker-init.xml b/reference/enchant/functions/enchant-broker-init.xml index 953928d13b..187d52c7b3 100644 --- a/reference/enchant/functions/enchant-broker-init.xml +++ b/reference/enchant/functions/enchant-broker-init.xml @@ -1,5 +1,5 @@ - + @@ -22,7 +22,8 @@ &reftitle.returnvalues; - Devuelve un recurso de sponsor en caso de éxito, &false; en caso contrario. + Devuelve una instancia de EnchantBroker en caso de + éxito&return.falseforfailure;. diff --git a/reference/enchant/functions/enchant-broker-list-dicts.xml b/reference/enchant/functions/enchant-broker-list-dicts.xml index 4dfdf8bc83..f776cd336e 100644 --- a/reference/enchant/functions/enchant-broker-list-dicts.xml +++ b/reference/enchant/functions/enchant-broker-list-dicts.xml @@ -1,6 +1,6 @@ - + @@ -32,6 +32,11 @@ + + &reftitle.errors; + &ext.enchant.broker-valueerror; + + &reftitle.changelog; diff --git a/reference/enchant/functions/enchant-broker-request-dict.xml b/reference/enchant/functions/enchant-broker-request-dict.xml index fafaf151bc..5f7bd8ae81 100644 --- a/reference/enchant/functions/enchant-broker-request-dict.xml +++ b/reference/enchant/functions/enchant-broker-request-dict.xml @@ -1,5 +1,5 @@ - + @@ -36,7 +36,17 @@ &reftitle.returnvalues; - Devuelve un recurso de diccionario en caso de éxito&return.falseforfailure;. + Devuelve una instancia de EnchantDictionary en caso de + éxito&return.falseforfailure;. + + + + + &reftitle.errors; + &ext.enchant.broker-valueerror; + + Lanza una ValueError si + tag está vacío. diff --git a/reference/enchant/functions/enchant-broker-request-pwl-dict.xml b/reference/enchant/functions/enchant-broker-request-pwl-dict.xml index 04ac8528cc..55f54785a7 100644 --- a/reference/enchant/functions/enchant-broker-request-pwl-dict.xml +++ b/reference/enchant/functions/enchant-broker-request-pwl-dict.xml @@ -1,5 +1,5 @@ - + @@ -38,10 +38,16 @@ &reftitle.returnvalues; - Devuelve un recurso de diccionario en caso de éxito&return.falseforfailure;. + Devuelve una instancia de EnchantDictionary en caso de + éxito&return.falseforfailure;. + + &reftitle.errors; + &ext.enchant.broker-valueerror; + + &reftitle.changelog; diff --git a/reference/enchant/functions/enchant-broker-set-ordering.xml b/reference/enchant/functions/enchant-broker-set-ordering.xml index ab2ceb6d4e..f23211ceb8 100644 --- a/reference/enchant/functions/enchant-broker-set-ordering.xml +++ b/reference/enchant/functions/enchant-broker-set-ordering.xml @@ -1,6 +1,6 @@ - + @@ -56,6 +56,15 @@ + + &reftitle.errors; + &ext.enchant.broker-valueerror; + + Lanza una ValueError si + tag u ordering está vacío. + + + &reftitle.changelog; @@ -67,6 +76,13 @@ + + 8.5.0 + + Ahora lanza una ValueError si + tag u ordering está vacío. + + &enchant.changelog.broker-param; diff --git a/reference/filesystem/functions/dirname.xml b/reference/filesystem/functions/dirname.xml index be8379f383..53ca998d12 100644 --- a/reference/filesystem/functions/dirname.xml +++ b/reference/filesystem/functions/dirname.xml @@ -1,5 +1,5 @@ - + @@ -107,6 +107,38 @@ dirname('C:\\'); // Devolverá 'C:\' en Windows y '.' en sistemas *nix. + + &reftitle.errors; + + Lanza una ValueError si levels + es menor que 1. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + Ahora lanza una ValueError si + levels es menor que 1. + Anteriormente, se emitía una E_WARNING y se devolvía &null;. + + + + + + + &reftitle.examples; diff --git a/reference/gettext/functions/dgettext.xml b/reference/gettext/functions/dgettext.xml index a33cde6c65..969632f236 100644 --- a/reference/gettext/functions/dgettext.xml +++ b/reference/gettext/functions/dgettext.xml @@ -1,6 +1,6 @@ - + @@ -57,9 +57,13 @@ &reftitle.errors; - Lanza una ValueError si domain - es un string vacío. - + Lanza una ValueError si domain + es un string vacío o tiene más de 1024 bytes. + + + Lanza una ValueError si message + tiene más de 4096 bytes. + @@ -80,6 +84,14 @@ es un string vacío. + + 8.0.0 + + Ahora lanza una ValueError si un argumento + es demasiado largo. Anteriormente, se emitía una E_WARNING + y se devolvía &false;. + + diff --git a/reference/gettext/functions/dngettext.xml b/reference/gettext/functions/dngettext.xml index 86d4326ea6..edb4a47d17 100644 --- a/reference/gettext/functions/dngettext.xml +++ b/reference/gettext/functions/dngettext.xml @@ -1,6 +1,6 @@ - + @@ -71,8 +71,12 @@ &reftitle.errors; - Genera una ValueError si domain - es un &string; vacío. + Lanza una ValueError si domain + es un &string; vacío o tiene más de 1024 bytes. + + + Lanza una ValueError si singular + o plural tiene más de 4096 bytes. @@ -94,6 +98,14 @@ es un &string; vacío. + + 8.0.0 + + Ahora lanza una ValueError si un argumento + es demasiado largo. Anteriormente, se emitía una E_WARNING + y se devolvía &false;. + + diff --git a/reference/info/functions/php-uname.xml b/reference/info/functions/php-uname.xml index 85c9575741..b944f143ed 100644 --- a/reference/info/functions/php-uname.xml +++ b/reference/info/functions/php-uname.xml @@ -1,6 +1,6 @@ - + @@ -102,6 +102,16 @@ + + &reftitle.errors; + + Lanza una ValueError si mode + no es un único carácter, o no es uno de "a", + "m", "n", "r", + "s" o "v". + + + &reftitle.changelog; @@ -116,7 +126,7 @@ 8.4.0 - Levanta una excepción ValueError cuando + Levanta una excepción ValueError cuando se especifica un mode inválido. diff --git a/reference/math/functions/base-convert.xml b/reference/math/functions/base-convert.xml index 3137db40e4..eeda44d4a3 100644 --- a/reference/math/functions/base-convert.xml +++ b/reference/math/functions/base-convert.xml @@ -1,5 +1,5 @@ - + @@ -77,6 +77,14 @@ + + &reftitle.errors; + + Lanza una ValueError si from_base o + to_base no está entre 2 y 36. + + + &reftitle.changelog; @@ -88,6 +96,14 @@ + + 8.0.0 + + Ahora lanza una ValueError si from_base o + to_base está fuera de rango. + Anteriormente, se emitía una E_WARNING y se devolvía &false;. + + 7.4.0 diff --git a/reference/math/functions/log.xml b/reference/math/functions/log.xml index 0a3ee8acc6..d0c609fff3 100644 --- a/reference/math/functions/log.xml +++ b/reference/math/functions/log.xml @@ -1,6 +1,6 @@ - + @@ -56,6 +56,38 @@ + + &reftitle.errors; + + Lanza una ValueError si base es menor + o igual que 0. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + Ahora lanza una ValueError si base es menor + o igual que 0. + Anteriormente, se emitía una E_WARNING y se devolvía &false;. + + + + + + + &reftitle.seealso; diff --git a/reference/stream/functions/stream-get-contents.xml b/reference/stream/functions/stream-get-contents.xml index 6baea34363..55ed9a237e 100644 --- a/reference/stream/functions/stream-get-contents.xml +++ b/reference/stream/functions/stream-get-contents.xml @@ -1,6 +1,6 @@ - + @@ -66,6 +66,13 @@ + + &reftitle.errors; + + Lanza una ValueError si length es menor que -1. + + + &reftitle.changelog; @@ -77,6 +84,13 @@ + + 8.0.0 + + Ahora lanza una ValueError si length es menor que -1. + Anteriormente, se emitía una E_WARNING y se devolvía &false;. + + 8.0.0 diff --git a/reference/stream/functions/stream-get-line.xml b/reference/stream/functions/stream-get-line.xml index 3188606377..bb420a9996 100644 --- a/reference/stream/functions/stream-get-line.xml +++ b/reference/stream/functions/stream-get-line.xml @@ -1,6 +1,6 @@ - + @@ -77,6 +77,36 @@ + + &reftitle.errors; + + Lanza una ValueError si length es negativo. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + Ahora lanza una ValueError si length es negativo. + Anteriormente, se emitía una E_WARNING y se devolvía &false;. + + + + + + + &reftitle.seealso; diff --git a/reference/stream/functions/stream-socket-enable-crypto.xml b/reference/stream/functions/stream-socket-enable-crypto.xml index 4420383cc7..3abf253836 100644 --- a/reference/stream/functions/stream-socket-enable-crypto.xml +++ b/reference/stream/functions/stream-socket-enable-crypto.xml @@ -1,6 +1,6 @@ - + @@ -104,6 +104,15 @@ + + &reftitle.errors; + + Lanza una ValueError si enable es &true;, + se omite crypto_method y el flujo no tiene la opción de + contexto SSL crypto_method. + + + &reftitle.changelog; @@ -115,6 +124,14 @@ + + 8.0.0 + + Ahora lanza una ValueError si se necesita crypto_method + pero no se proporciona. + Anteriormente, se emitía una E_WARNING y se devolvía &false;. + + 8.0.0 diff --git a/reference/stream/functions/stream-socket-recvfrom.xml b/reference/stream/functions/stream-socket-recvfrom.xml index fdbe727753..9c5e061259 100644 --- a/reference/stream/functions/stream-socket-recvfrom.xml +++ b/reference/stream/functions/stream-socket-recvfrom.xml @@ -1,6 +1,6 @@ - + @@ -94,6 +94,36 @@ + + &reftitle.errors; + + Lanza una ValueError si length es menor que 1. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + Ahora lanza una ValueError si length es menor que 1. + Anteriormente, se emitía una E_WARNING y se devolvía &false;. + + + + + + + &reftitle.examples; diff --git a/reference/stream/functions/stream-socket-shutdown.xml b/reference/stream/functions/stream-socket-shutdown.xml index 11d37d11d9..a7f5741ee6 100644 --- a/reference/stream/functions/stream-socket-shutdown.xml +++ b/reference/stream/functions/stream-socket-shutdown.xml @@ -1,6 +1,6 @@ - + @@ -60,6 +60,38 @@ + + &reftitle.errors; + + Lanza una ValueError si mode no es + STREAM_SHUT_RD, STREAM_SHUT_WR + o STREAM_SHUT_RDWR. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + Ahora lanza una ValueError si mode no es válido. + Anteriormente, se emitía una E_WARNING y se devolvía &false;. + + + + + + + &reftitle.examples;