On 20.12.2016 at 06:47, Sam Hobbs wrote: > In addition to the "->" and "::" operators, the following probably need > more documentation too. I will list them followed by a comment in a > separate line for each; note that "{$" and "${" are two operators > (experienced PHP programmers know that I am sure). > > => > described in Array Operators but not in the table at the top of that page I'm not sure whether => should be regarded an operator. It appears to be rather a syntactic token for array-element-initializer[1] and foreach-key[2]. > () > not mentioned in "Array Operators", but is an operator for arrays, correct? Do you mean [] and/or {}? These are called subscript operator by the PHP language specification[3]. > () > type-casting; not described as an operator These are listed in the operator precedence table (`(unset)`, `(binary)` and the aliases are missing, though), so should probably also be described in the operator section. > () > precedence; described in "Operator Precedence" but "()" is not described > as an operator or operators but probably should be What is descibed in the "Operarator Precedence" section is the use of parens to enforce a certain order of evaluation. That is not an operator, though. The function call operator[4] appears to be not documented in the "Operators" chapter. > {$ and ${ > undocumented, barely described and they need better names I'm not sure whether these should be called operators at all, because they're only used inside string literals > .... > > called a token in "Function arguments" so it is not clear to me that it > is an operator but "..." seems to have multiple uses, none adequately > documented. In my opinion, this is not an operator. The usage is documented in the "Variable-length argument lists" section[5]. > Note that also the "Assignment Operators" page has a note written 12 > years ago saying it "ought to have table of assignment operators". Patches are certainly welcome! For instance, via <https://edit.php.net/>. [1] <https://github.com/php/php-langspec/blob/master/spec/10-expressions.md#array-creation-operator> [2] <https://github.com/php/php-langspec/blob/master/spec/11-statements.md#the-foreach-statement> [3] <https://github.com/php/php-langspec/blob/master/spec/10-expressions.md#subscript-operator> [4] <https://github.com/php/php-langspec/blob/master/spec/10-expressions.md#function-call-operator> [5] <http://php.net/manual/en/functions.arguments.php#functions.variable-arg-list> -- Christoph M. Becker -- PHP General Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php