From 3898693aca5ec93cf53c3c10ec739ea9257e9f83 Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Thu, 27 Aug 2026 17:46:16 +0200
Subject: [PATCH] [Sync-En] array: add example on updating values with
 array_walk_recursive()

---
 .../array/functions/array-walk-recursive.xml  | 40 ++++++++++++++++++-
 1 file changed, 39 insertions(+), 1 deletion(-)

diff --git a/reference/array/functions/array-walk-recursive.xml b/reference/array/functions/array-walk-recursive.xml
index ab9e8da2d..ffad7d56d 100644
--- a/reference/array/functions/array-walk-recursive.xml
+++ b/reference/array/functions/array-walk-recursive.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 63f09f4d816aa29c3f8fba9d12a8c6ce2f1755de Maintainer: PhilDaiguille Status: ready -->
+<!-- EN-Revision: 0d8ee2131b4da66a4d274c576da9137c2a7963d5 Maintainer: PhilDaiguille Status: ready -->
 <refentry xml:id="function.array-walk-recursive" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>array_walk_recursive</refname>
@@ -133,6 +133,44 @@ La clave sour contiene el elemento lemon
     </para>
    </example>
   </para>
+  <simpara>
+   <function>array_walk_recursive</function> también puede utilizarse para
+   actualizar los valores in situ pasando el parámetro de la retrollamada por referencia.
+  </simpara>
+  <para>
+   <example>
+    <title>Actualización de los valores in situ</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$sweet = ['a' => 'apple', 'b' => 'banana'];
+$fruits = ['sweet' => $sweet, 'sour' => 'lemon'];
+
+function test_update(&$item)
+{
+    $item = strtoupper($item);
+}
+
+function test_print($item, $key)
+{
+    echo "La clave $key contiene el elemento $item\n";
+}
+
+array_walk_recursive($fruits, 'test_update');
+array_walk_recursive($fruits, 'test_print');
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+La clave a contiene el elemento APPLE
+La clave b contiene el elemento BANANA
+La clave sour contiene el elemento LEMON
+]]>
+    </screen>
+   </example>
+  </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;