# reqwest.form

## 功能

设置 application/x-www-form-urlencoded 表单请求体。

## 语法

```bt
reqwest(url).form(values)
```

## 参数

| 参数 | 类型 | 必填 | 默认值 | 说明 |
| ------ | ------ | ------ | ------ | ------ |
| values | Object | 否 | 无 | 表单字段映射对象；键和值的规则见下方。 |

## values 对象结构

| 键 | 值类型 | 说明 |
| ------ | ------ | ------ |
| 表单字段名 | Any | 要写入 `application/x-www-form-urlencoded` 请求体的字段值；调用时会转为字符串。 |

## 返回值

| 类型 | 说明 |
| ------ | ------ |
| Reqwest | 返回新的请求构建器。 |

## 示例

```bt
// 发送表单字段 name=BT。
request = reqwest('https://example.com').method('POST').form({name: 'BT'})
result = type(request)

// 输出：Reqwest
print result
```

## 注意事项

- values 必须是对象，否则会报错。
- body、json、form、multipart 都会设置请求体；同一请求中最后一次设置的请求体生效。