62 lines
1.3 KiB
Markdown
62 lines
1.3 KiB
Markdown
---
|
|
{
|
|
"title": "nullif",
|
|
"language": "en"
|
|
}
|
|
---
|
|
|
|
<!--
|
|
Licensed to the Apache Software Foundation (ASF) under one
|
|
or more contributor license agreements. See the NOTICE file
|
|
distributed with this work for additional information
|
|
regarding copyright ownership. The ASF licenses this file
|
|
to you under the Apache License, Version 2.0 (the
|
|
"License"); you may not use this file except in compliance
|
|
with the License. You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing,
|
|
software distributed under the License is distributed on an
|
|
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
|
KIND, either express or implied. See the License for the
|
|
specific language governing permissions and limitations
|
|
under the License.
|
|
-->
|
|
|
|
## nullif
|
|
### description
|
|
#### Syntax
|
|
|
|
`nullif(expr1, expr2)`
|
|
|
|
|
|
If the two parameters are equal, null is returned. Otherwise, the value of the first parameter is returned. It has the same effect as the following `case when`
|
|
|
|
```
|
|
CASE
|
|
WHEN expr1 = expr2 THEN NULL
|
|
ELSE expr1
|
|
END
|
|
```
|
|
|
|
### example
|
|
|
|
```
|
|
mysql> select nullif(1,1);
|
|
+--------------+
|
|
| nullif(1, 1) |
|
|
+--------------+
|
|
| NULL |
|
|
+--------------+
|
|
|
|
mysql> select nullif(1,0);
|
|
+--------------+
|
|
| nullif(1, 0) |
|
|
+--------------+
|
|
| 1 |
|
|
+--------------+
|
|
```
|
|
### keywords
|
|
NULLIF
|