Skip to content

Update null coalesce operator documentation #5255

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
lacatoire wants to merge 1 commit into from
Closed

Update null coalesce operator documentation #5255

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 14 additions & 5 deletions language/operators/comparison.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -500,11 +500,20 @@ if (isset($_POST['action'])) {
<replaceable>expr2</replaceable> if <replaceable>expr1</replaceable> is
&null;, and <replaceable>expr1</replaceable> otherwise.
</para>
<para>
In particular, this operator does not emit a notice or warning if the left-hand side
value does not exist, just like <function>isset</function>. This is especially
useful on array keys.
</para>
<simpara>
In particular, this operator does not emit a notice or warning if the
left-hand side value does not exist, just like <function>isset</function>.
This is especially useful on array keys.
This suppression only applies when the left-hand operand is a variable
expression: a combination of variable accesses
(<literal>$var</literal>), array accesses (<literal>$var['key']</literal>),
property accesses (<literal>$var->prop</literal>), null-safe property and
method accesses (<literal>$var?->prop</literal>,
<literal>$var?->method()</literal>), static property accesses
(<literal>Class::$prop</literal>), and function/method calls.
If the left-hand operand is a more complex expression (such as a
concatenation or arithmetic operation), warnings will not be suppressed.
</simpara>
<note>
<simpara>
Please note that the null coalescing operator is an expression, and that it
Expand Down
Loading