# Timer.cancel

## 功能

取消 `set_timeout()` 或 `set_interval()` 返回的 `Timer` 对象。取消成功返回 `true`，已经取消或已经完成时返回 `false`。

## 语法

```bt
ok = timer.cancel()
```

## 参数

| 参数 | 类型 | 必填 | 默认值 | 说明 |
| ------ | ------ | ------ | ------ | ------ |
| 无 | - | - | - | `cancel()` 不接收参数。 |

## 返回值

| 类型 | 说明 |
| ------ | ------ |
| Bool | 成功取消活动 timer 返回 `true`，否则返回 `false`。 |

## 示例

```bt
timer = set_timeout(fn() {
    println('不会执行')
}, 1000)

ok = timer.cancel()

// 输出：true
print ok
```

## 注意事项

- `cancel()` 不会中断正在执行中的回调，只会阻止后续触发。
- timeout 回调已经开始或已经完成后，再调用 `cancel()` 返回 `false`。
- interval 回调内部调用 `self.cancel()` 时，本轮回调继续执行，后续不再调度。