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

检查数据是否为有效的中国身份证

### 
```php
bool isIdCardCn( $input )
```

##### 参数
* **$input** `mixed` 待验证的数据

##### 错误信息
| **名称**              | **信息**                                                       | 
|-----------------------|----------------------------------------------------------------|
| `invalid`             | %name%必须是有效的中国身份证                                   |
| `negative`            | %name%不能是有效的中国身份证                                   |
| `notString`           | %name%必须是字符串                                             |

##### 代码范例
检查15位数字"342622840209049"是否为有效的中国身份证
```php
<?php

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

检查数据是否为有效的中国身份证

案例
----

### 检查15位数字"342622840209049"是否为有效的中国身份证
```php
if ($widget->isIdCardCn('342622840209049')) {
    echo 'Yes';
} else {
    echo 'No';
}
```

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

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

### 选项

| 名称                | 类型    | 默认值                           | 说明              |
|---------------------|---------|----------------------------------|-------------------|
| notStringMessage    | string  | %name%必须是字符串               | -                 |
| invalidMessage      | string  | %name%必须是有效的中国身份证     | -                 |
| negativeMessage     | string  | %name%不能是有效的中国身份证     | -                 |

### 方法

#### isIdCardCn($input)
检查数据是否为有效的中国身份证
{'fraction_non_alphanumeric': 0.2937888198757764, 'fraction_numerical': 0.03975155279503106, 'mean_word_length': 1.25, 'pattern_counts': {'":': 0, '<': 4, '<?xml version=': 0, '>': 5, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 10, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2452923', 'n_tokens_mistral': 641, 'n_tokens_neox': 635, 'n_words': 70}