<commit_before>[isRequired()](http://twinh.github.io/widget/api/isRequired)
============================================================

检查数据是否为空

### 
```php
bool isRequired( $input [, $required ] )
```

##### 参数
* **$input** `mixed` 待验证的数据
* **$required** `bool` true表示数据不可以为空,false表示数据可为空


用于组合验证,如果允许为空且数据为空,则不对数据进行剩余规则的校验

##### 错误信息
| **名称**              | **信息**                                                       | 
|-----------------------|----------------------------------------------------------------|
| `required`            | %name%不能为空                                                 |
| `notString`           | %name%必须是字符串                                             |
| `negative`            | %name%不合法                                                   |


##### 代码范例
检查null是否为空
```php
<?php

if ($widget->isRequired(null)) {
    echo 'Yes';
} else {
    echo 'No';
}
```
##### 运行结果
```php
'No'
```
##### 代码范例
检查null是否为空,第二个参数设为false
```php
<?php

if ($widget->isRequired(null, false)) {
    echo 'Yes';
} else {
    echo 'No';
}
```
##### 运行结果
```php
'Yes'
```<commit_msg>updated isRequired validator doc<commit_after>isRequired
==========

检查数据是否为空

案例
----

### 检查null是否为空
```php
if ($widget->isRequired(null)) {
    echo 'Yes';
} else {
    echo 'No';
}
```

#### 运行结果
```php
'No'
```

### 检查null是否为空,第二个参数设为false
```php
if ($widget->isRequired(null, false)) {
    echo 'Yes';
} else {
    echo 'No';
}
```

#### 运行结果
```php
'Yes'
```

调用方式
--------

### 选项

| 名称              | 类型    | 默认值                                                 | 说明                 |
|-------------------|---------|--------------------------------------------------------|----------------------|
| requiredMessage   | string  | %name%不能为空                                         | -                    |
| negativeMessage   | string  | %name%不合法                                           | -                    |

### 方法

#### isRequired($input, $required = true)
检查数据是否为空
{'fraction_non_alphanumeric': 0.2945932289034866, 'fraction_numerical': 0.0, 'mean_word_length': 1.2, 'pattern_counts': {'":': 0, '<': 5, '<?xml version=': 0, '>': 7, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 16, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '5751837', 'n_tokens_mistral': 682, 'n_tokens_neox': 689, 'n_words': 101}