diff --git a/core/lib/Drupal/Component/Utility/NestedArray.php b/core/lib/Drupal/Component/Utility/NestedArray.php index 8e00e068a4a43ff5f66ada93ad529bbca301bc71..c494c24e900746b0eb7fa231e7e9f9b86eba1757 100644 --- a/core/lib/Drupal/Component/Utility/NestedArray.php +++ b/core/lib/Drupal/Component/Utility/NestedArray.php @@ -34,10 +34,10 @@ class NestedArray { * $value = NestedArray::getValue($form, $parents); * @endcode * - * The return value will be NULL, regardless of whether the actual value is - * NULL or whether the requested key does not exist. If it is required to know - * whether the nested array key actually exists, pass a third argument that is - * altered by reference: + * A return value of NULL is ambiguous, and can mean either that the requested + * key does not exist, or that the actual value is NULL. If it is required to + * know whether the nested array key actually exists, pass a third argument + * that is altered by reference: * @code * $key_exists = NULL; * $value = NestedArray::getValue($form, $parents, $key_exists);