Changeset 60618

Timestamp:

08/07/2025 02:45:05 PM (6 months ago)

Author:

SergeyBiryukov

Message:

Docs: Correct return and parameter types for WP_Block_List methods.

Follow-up to [48159], [56803].

Props marian1.
Fixes #63753.

File:

• trunk/src/wp-includes/class-wp-block-list.php (modified) (6 diffs)

trunk/src/wp-includes/class-wp-block-list.php

@@ -68 +68 @@
      * @link https://www.php.net/manual/en/arrayaccess.offsetexists.php
      *
-     * @param string $offset Offset of block to check for.
+     * @param int $offset Offset of block to check for.
      * @return bool Whether block exists.
      */
@@ -83 +83 @@
      * @link https://www.php.net/manual/en/arrayaccess.offsetget.php
      *
-     * @param string $offset Offset of block value to retrieve.
-     * @return mixed|null Block value if exists, or null.
+     * @param int $offset Offset of block value to retrieve.
+     * @return WP_Block|null Block value if exists, or null.
      */
     #[ReturnTypeWillChange]
@@ -106 +106 @@
      * @link https://www.php.net/manual/en/arrayaccess.offsetset.php
      *
-     * @param string $offset Offset of block value to set.
-     * @param mixed  $value Block value.
+     * @param int            $offset Offset of block value to set.
+     * @param array|WP_Block $value  Block value.
      */
     #[ReturnTypeWillChange]
@@ -125 +125 @@
      * @link https://www.php.net/manual/en/arrayaccess.offsetunset.php
      *
-     * @param string $offset Offset of block value to unset.
+     * @param int $offset Offset of block value to unset.
      */
     #[ReturnTypeWillChange]
@@ -151 +151 @@
      * @link https://www.php.net/manual/en/iterator.current.php
      *
-     * @return mixed Current element.
+     * @return WP_Block|null Current element.
      */
     #[ReturnTypeWillChange]
@@ -165 +165 @@
      * @link https://www.php.net/manual/en/iterator.key.php
      *
-     * @return mixed Key of the current element.
+     * @return int|null Key of the current element.
      */
     #[ReturnTypeWillChange]