# 正規表達式

### 說明

在 YOCTOL.AI 中 [觸發條件](https://docs.yoctol.ai/term/trigger) 的 **正規表達式** (Regular Expression)，根據其名可解釋為 描述某種規則的表達式 ，是用來檢索、搜尋或替換符合某個模式或特定排列組合的文字。又名為正規表示式、正則表達式、正規表示法、正規運算式、規則運算式、常規表示法，英文名亦可簡稱 Regexp、Regex 或 RE。

### 範例

我們知道語言的表現方式有百百種，同一句話或是一種表達可以有很多表現方式。又或是不同的表達中有很相似的結構類型。這些可以透過觀察，歸納出某個特定的規則或規律來說明、囊括某一種結構或形式相似的表達。

例如：`大杯紅茶、中杯紅茶、小杯奶茶、中杯綠茶`等，我們可以知道是兩個基本特徵變項的組合： `飲料的尺寸`及`茶飲品項`。

這時我們就可以把`大杯、中杯、小杯`歸納成一類，`紅茶、奶茶、綠茶`歸納成一類。進而推演出一個規則，囊括有各種尺寸的飲料品項的表達。

| 尺寸                    | 品項                    |
| --------------------- | --------------------- |
| <p>大杯<br>中杯<br>小杯</p> | <p>紅茶<br>奶茶<br>綠茶</p> |

而在語言上的寫法就可以透過正規表達式來實現寫出這樣的規則：

> (大|中|小)杯 (紅|奶|綠)茶

### 一般常用場景

正規表達式常被用在蒐集電子郵件、手機號碼、身份證字號或是生日等結構類似的文字表達方面。

> 手機號碼： ^09\d{8}$&#x20;
>
> 身分證字號：^\[A-Z]\d{9}$&#x20;
>
> 電子信箱（以 gmail 為例）：^.\*@gmail.com$&#x20;
>
> 生日：^\d{4}-\d{2}-\d{2}$

### 使用正規表達式的時機

我們在建置聊天機器人時，有時會希望使用者輸入的某些話，可以精確進入某個意圖，進而編寫腳本回應。而這些用語可能展現了特定的文字組合規則，若逐一窮盡舉出，不但耗費時間且有遺漏的可能。

這時，使用正規表達式就是最好的幫手。而常用在建置機器人的情境當中，歸納使用者的話語時，可能想要包括、排除、或是範圍內限定某些表達，例如：要包括特定用詞、排除某種語言、限定第幾個字元為某個字等等。我們在稍後會以 實際範例 來做說明。

### 符碼意義

基本規則：符號是用來限定前面字元允許出現的個數。這邊簡單介紹幾個常用到的表達式符號，更多詳細可以查詢各網站符碼對照表。

| 符號 | 意義       | 舉例  | 表達                    |
| -- | -------- | --- | --------------------- |
| .  | 任一字元     | .   | `你`、`妳`、`我`、`他`       |
| \* | 0 個或以上字元 | 你\* | Ø、`你`、`你你`、`你你你`      |
| +  | 1 個或以上字元 | 你+  | `你`、`你你`、`你你你`、`你你你你` |
| ?  | 0 個或 1 個 | 你?  | Ø、`你`                 |

**^**   開頭限定     e.g.,  ^你好          >>> (符合) `你好`   >>> (不符合) ~~`哈囉你好`~~

**$**  結尾限定   e.g.,   .+吃$            >>> (符合) `我要吃`  >>> (不符合) ~~`我吃東西`~~&#x20;

**|**  或    e.g.,    妳|你                        >>>   `妳`、`你`&#x20;

**( )** 定義操作符的範圍和優先度   e.g.,  (你好|你很好)       >>> `你好`、`你很好`

\[ **]**  字元集合，`[]`其中任一個字元   e.g.,  \[你我他]           >>> `你`、`我`、`他`&#x20;

**{ }** 符號數量範圍，`{}`的數字表示限制的數量  e.g.,    .{2}     >>> `妳好`、`哈囉`、`吃飯`、`走路`&#x20;

&#x20;**\d**  任一數字   e.g.,   \d{3}        >>>  `123`、`333`、`459`

### 情境示例

以服飾電商為情境，我們想訓練一個意圖，知識範圍包含服飾中不同顏色的庫存狀態。

> 對於 `顏色` 和`服飾種類` 的組合有很多種表達：

* 紅色的牛仔褲、藍色的上衣、黃色短褲、綠色薄外套、黃色薄外套、綠色的短褲

不同`顏色`與`服飾種類`的排列組合會有眾多可能，此時就可以利用正規表達式，將所有可能性列出。

| 顏色          | 服飾種類          |
| ----------- | ------------- |
| 紅色、藍色、黃色、綠色 | 牛仔褲、上衣、短褲、薄外套 |

正規表達式可以寫為：

> (紅|藍|黃|綠)色(牛仔褲|短褲|上衣|薄外套)

然而使用者也很可能在字串中間，加入其他的詞來表達，例如 `的`：

* 紅色的上衣、綠色的短褲、紅色的牛仔褲、藍色的上衣、黃色短褲、綠色薄外套、綠色的短褲、深綠色短褲、亮藍色的上衣

在此情況下，正規表達式可寫為：

> (紅|藍|黃|綠)色.?(牛仔褲|短褲|上衣|薄外套)

再更進階一點，我們想要對顏色進行更清楚的描述，例如`淺紅色`、`亮黃`、`深綠`都想要搜尋到，則正規表達式可寫為：

> (淺|亮|深)(紅|藍|黃|綠)色.?(牛仔褲|短褲|上衣|薄外套)

若想抓出搜尋款式樣式的句型，例如：「我要找 OOO 的款式、我想要找 OOO 的樣式的褲子、我想要找 OOO 的樣式的褲子」，正規表達式可寫為：

> ^我(要|想要)找.\*的(款式|樣式)$

### 學習資源

在編寫正規表達式時，除了要熟悉各符號的意義，也需要謹慎確認該表達式是否能正確呈現您想要表達的意思。我們提供幾個網站，供您練習時參考。

* 檢測表達式：[Regex101](https://regex101.com/)
* 檢測表達式：[Regexr](https://regexr.com/)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-tw.yoctol.ai/term/regex.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.