php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #49834 array_* functions badly documented
Submitted: 2009-10-10 20:56 UTC Modified: 2009-11-13 21:07 UTC
Votes:1
Avg. Score:5.0 ± 0.0
Reproduced:1 of 1 (100.0%)
Same Version:1 (100.0%)
Same OS:1 (100.0%)
From: sqw at guerrillamailblock dot com Assigned:
Status: Closed Package: Documentation problem
PHP Version: Irrelevant OS: all
Private report: No CVE-ID: None
 [2009-10-10 20:56 UTC] sqw at guerrillamailblock dot com
Description:
------------
if someone here is listening: i am targeting the array_* functions. i demand crystal clear distinction between the terms "key", "value", and "entry" (a.k.a. "key => value pair"). for example things like "array_intersect_key: Returns an associative array containing all the values of array1  which have matching keys that are present in all arguments. " are not acceptable. here, "value" actually denotes entry. compare array_diff_key. also "matching" is nonsensical here. next thing "array_diff_key: Returns an array containing all the entries from array1  that are not present in any of the other arrays." is directly copied from array_diff, and wrong thus. it should read "Returns an array containing all the entries from array1 whose keys are not present in any of the other arrays. "


Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2009-11-13 21:06 UTC] svn@php.net
Automatic comment from SVN on behalf of vrana
Revision: http://svn.php.net/viewvc/?view=revision&revision=290698
Log: Terminology (bug #49834)
 [2009-11-13 21:07 UTC] vrana@php.net
This bug has been fixed in the documentation's XML sources. Since the
online and downloadable versions of the documentation need some time
to get updated, we would like to ask you to be a bit patient.

Thank you for the report, and for helping us make our documentation better.


 
PHP Copyright © 2001-2026 The PHP Group
All rights reserved.
Last updated: Wed Jun 17 02:00:02 2026 UTC