Source: https://dev-docs.yueshu.com.cn/v5.3.2/database-gql-reference/fe/predicates/labeled/
Documentation version: v5.3.2

# 标签谓词

标签谓词检查图元素是否具有特定标签。

## 语法

语法图源码

 labeled_predicate  

````
labeled_predicate ::=
    element_variable_reference ( ('IS' 'NOT'? 'LABELED') | ':') label_expression

````

## 参数

### `element_variable_reference`

图元素的引用变量。

### `IS LABELED`

检查图元素是否具有特定标签的关键字。可以使用冒号（`:`）作为`IS LABELED`的简写。

### `label_expression`

待检查是否存在的标签表达式。更多信息，请参见[标签表达式](https://dev-docs.yueshu.com.cn/v5.3.2/database-gql-reference/fe/expressions/label/)。

## 示例

以下示例基于[示例数据集](https://dev-docs.yueshu.com.cn/v5.3.2/database-gql-reference/overview/example-dataset/)。

### 查询具备特定标签的点

````
'''
USE movie 
MATCH (v)-[e]->() 
WHERE v IS LABELED Person 
RETURN DISTINCT v.name AS name 
LIMIT 5
'''

````

返回：

````
+-----------------+
| name            |
+-----------------+
| F.W. Murnau     |
| Leonard Nimoy   |
| Wim Wenders     |
| Angela Robinson |
| Gurinder Chadha |
+-----------------+

````

### 查询具备特定标签的边

````
'''
USE movie 
MATCH (v)-[e]->() 
WHERE e:Act 
RETURN DISTINCT e AS `edge` 
LIMIT 5
'''

````

返回：

````
+----------------------------------------------------------+
| edge                                                     |
+----------------------------------------------------------+
| (288314978417508353)-[0@Act:Act{}]->(289275367464632321) |
| (288315107266527233)-[0@Act:Act{}]->(289301850232979457) |
| (288315111561494529)-[0@Act:Act{}]->(289148695994171393) |
| (288315154511167489)-[0@Act:Act{}]->(289308997058560001) |
| (288315158806134785)-[0@Act:Act{}]->(289154137717735425) |
+----------------------------------------------------------+

````

### 查询不具备特定标签的点

````
'''
USE movie 
MATCH (v)-[e]->() 
WHERE v IS NOT LABELED Person 
RETURN DISTINCT v.name 
LIMIT 5
'''

````

返回：

````
+-------------------------+
| v.name                  |
+-------------------------+
| Magnetic Rose           |
| Rebel without a Cause   |
| Hero                    |
| The 5th Element         |
| Star Trek: Insurrection |
+-------------------------+

````