C/C++字符串操作与安全API详解

慢慢来

发布时间：2026-10-15| 4人浏览过

原创

C/C++开发中字符串操作是基础且关键的环节。为了避免传统的gets或strcpy带来的缓冲区溢出风险，现代C/C++推荐使用安全版本的API，如带后缀_s的函数。本文整理了从宽/窄字符串转换、内存初始化比对到Windows系统级接口（如UUID生成、配置文件读写）的常用函数，配合标准代码示例，提供一份实用的操作参考。

标准字符串的安全复制与格式化

在进行字符串拷贝时，明确目标缓冲区的大小至关重要。

第1步：使用 wcsncpy_s 进行宽字符串安全拷贝

目的：将源宽字符串的内容复制到目标缓冲区，并确保始终终止空字符，防止越界。

头文件：<wchar.h>

语法：

errno_t wcsncpy_s(
   wchar_t *strDest,
   size_t numberOfElements,
   const wchar_t *strSource,
   size_t count
);

strDest：目标字符串数组。
numberOfElements：目标数组的大小（元素个数）。
strSource：源字符串。
count：要复制的最大字符数。

代码示例：

#include <stdio.h>
#include <wchar.h>
#include <locale.h>

int main(void)
{
    const wchar_t src[] = L"南京";
    wchar_t dest[6] = { L'北', L'京', L'上', L'海', L'深' };

    // 复制前3个字符
    wcsncpy_s(dest, 3, src, 3);

    puts("The contents of dest are: ");
    setlocale(LC_ALL, "en_US.utf8");

    for (wchar_t* p = dest; *p != L'\0'; ++p) {
        printf("%lc ", *p);
    }
}

结果分析：程序输出为“南京 ”，后续内存未被清空但不再作为有效字符串内容读取。此函数会自动在末尾填充Null字符。

第2步：使用 swprintf_s 进行格式化写入

目的：将格式化的数据写入宽字符串缓冲区。

头文件：<stdio.h> 或 <wchar.h>

语法：

int swprintf_s(
   wchar_t *buffer,
   size_t sizeOfBuffer,
   const wchar_t *format,
   ...
);

类似地，窄字符使用 sprintf_s。这两个函数相比原生sprintf更安全，因为它们接受缓冲区大小参数并强制添加结尾的Null字符。

内存块的操作：设置、复制与比较

对于非字符串的二进制数据或需要快速清空的区域，以下函数提供了底层控制。

第3步：memset 初始化内存

用途：将指定内存块的前N个字节设置为特定值（通常为0或-1）。常用于结构体清零。

原型：void * memset ( void * ptr, int value, size_t num );

注意事项：value参数虽然类型为int，但在填充时会转换为unsigned char。因此只适合用于赋值0或-1(FF)，否则可能产生未定义行为。

第4步：memcpy 与 memcmp 的使用

memcpy：用于逐字节复制内存块，不区分数据类型，速度极快。适用场景包括结构体整体拷贝、内存池分配等。

void * memcpy ( void * destination, const void * source, size_t num );

memcmp：按字节顺序比较两个内存块。不同于strcmp，它不以Null字符为结束标志，直到比较完num个字节或发现差异为止。

返回值 < 0：ptr1 小于 ptr2
返回值 > 0：ptr1 大于 ptr2
返回值 = 0：两者相等

排错提示：在使用memcpy时，务必确保目标内存空间已预先分配且足够大，否则会导致栈溢出或堆损坏。

Windows 平台专属 API

在Windows环境下开发GUI应用或服务端程序时，常需调用Win32 API处理资源字符串、UUID标识及配置文件。

第5步：加载与检索模块字符串

LoadStringW：从DLL或EXE的资源表中加载Unicode字符串。常用于多语言支持。

int LoadStringW(
  HINSTANCE hInstance,
  UINT      uID,
  LPWSTR    lpBuffer,
  int       cchBufferMax
);

通常先结合 GetModuleHandleW 获取当前模块句柄：HMODULE GetModuleHandleW(LPCWSTR lpModuleName);（传入NULL获取当前进程实例）。

第6步：UUID（GUID）的创建、比较与转换

UUID是通用唯一识别码，广泛用于COM对象、分布式系统ID等场景。

UuidCreate：生成一个新的UUID。RPC_STATUS UuidCreate(UUID *Uuid);
UuidFromStringW：将字符串格式的UUID（如"{xxxxxxxx...}"）转为二进制结构。需链接 Rpcrt4.lib。
UuidCompare：比较两个UUID的大小，返回 -1, 0, 1。
UuidHash：对UUID生成一个哈希值，适用于映射表索引。

第7步：INI 文件读写配置

WritePrivateProfileStringA/W：向初始化文件写入键值对。

BOOL WritePrivateProfileStringA(
  LPCSTR lpAppName,    // Section名称
  LPCSTR lpKeyName,    // Key名称
  LPCSTR lpString,     // Value字符串
  LPCSTR lpFileName    // 文件名（可为绝对路径）
);

若lpKeyName传NULL，则删除整个Section；若lpString传NULL，则删除指定Key。这是Windows早期配置管理的标准做法，但在现代应用中正逐渐被JSON/XML取代。