# std::strlen

< cpp‎ | string‎ | byte

定义于头文件 `<cstring>` |  |
std::size_t strlen( const char* str ); |  |

返回给定字节字符串的长度，即首元素为 `str` 所指向的字符数组直到而不包含首个空字符的字符数。若 `str` 所指向的字符数组中无空字符，则行为未定义。

### 参数

str | - | 指向要检验的空终止字节字符串的指针

### 返回值

空终止字符串 `str` 的长度。

### 示例

    #include <cstring>
    #include <iostream>

    int main()
    {
       const char str[] = "How many characters does this string contain?";

       std::cout << "without null character: " << std::strlen(str) << '\n'
                 << "with null character: " << sizeof str << '\n';
    }

输出：

    without null character: 45
    with null character: 46

### 参阅

wcslen | 返回宽字符串长度 (函数)
mblen | 返回下一个多字节字符中的字节数 (函数)