Win32 API (2) lstrlen

lstrlen

像很多和字符串有关的 Windows API 一样，lstrlen 是一个宏，有 ASCII 和 UNICODE 两个版本：

#ifdef UNICODE
#define lstrlen  lstrlenW
#else
#define lstrlen  lstrlenA

函数原型：

int lstrlenA(
  LPCSTR lpString
);

int lstrlenW(
  LPCWSTR lpString
);

函数原型除掉参数类型略有差异以外，其他都是完全一致的。该函数计算给定的字符串的长度，结果不包含结尾的空字符。

参数说明：

lpString ：一个以空字符结束的字符串，函数将检查该字符串的长度。类型 LPCSTR 是 const char * ，而类型 LPCWSTR 本质上就是 const wchar_t * 。

返回值说明：

函数返回字符串的长度（包含字符的个数），当参数字符串是 NULL，则函数返回 0。

依赖信息：

名称	值
Header	winbase.h (include Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll

lstrlen 函数是 Windows API ，在C标准库中也定义了功能类似的两个函数，分别对应普通字符和宽字符版本：

//等价于 lstrlenA
size_t strlen( const char *str );
//等价于 lstrlenW
size_t wcslen( const wchar_t *str );

还有两个相应的安全版本，可以指定需要检查的最长字符数。当检查了给定个数的字符以后，如果还是没有碰到空字符则函数返回给定的长度，这个特性往往用于不信任的数据的检查：

//字节串
size_t strnlen_s( const char *str, size_t strsz );
//宽字符
size_t wcsnlen_s(const wchar_t *str, size_t strsz);