鱼C论坛

 找回密码
 立即注册
查看: 18499|回复: 12

[API档案] StringCchPrintf

[复制链接]
发表于 2014-7-19 16:36:11 | 显示全部楼层 |阅读模式

马上注册,结交更多好友,享用更多功能^_^

您需要 登录 才可以下载或查看,没有账号?立即注册

x
函数功能:

StringCchPrintf 函数用于把数据格式化写入到指定的缓冲区里,该函数要求提供目标缓冲区的大小,确保不会发生越界访问。

微软推荐使用该函数替代以下函数:

  • sprintf, swprintf, _stprintf
  • wsprintf
  • wnsprintf
  • _snprintf, _snwprintf, _sntprintf


API 函数原型:
HRESULT StringCchPrintf(
  _Out_  LPTSTR pszDest,
  _In_   size_t cchDest,
  _In_   LPCTSTR pszFormat,
  _In_   ...
);

参数解析:

参数 含义
pszDest 指定格式化数据将要写入的缓冲区
cchDest 1. 缓冲区大小
2. 应该设置足够大,以容纳字符串和结束标记('\n')
3. 最大允许的字符数是 STRSAFE_MAX_CCH
pszFormat 1. 格式化字符串
2. 与 pirntf 的格式化字符串一致
... 可变参数,参数的个数取决 pszFormat 参数


返回值:

这个函数返回一个 HRESULT,而不是像 sprintf 一样返回存储在其目标缓冲区的字节数。我们强烈建议您使用 SUCCEEDEDFAILED 宏来测试这个函数的返回值。

返回值可以是以下任意一个值:

返回代码描述
S_OK 表示有足够的空间将拷贝到 pszDest,没有发生截断
STRSAFE_E_INVALID_PARAMETER cchDest 的值为 0 或大于 STRSAFE_MAX_CCH
STRSAFE_E_INSUFFICIENT_BUFFER 1. 由于缓冲区空间不足而导致的复制失败
2. 结果被截断,当仍然包含'\0'结尾
3. 如果截断操作可以被接受,则不一定被看作是失败


备注:

使用 StringCchPrintf 函数需要添加头文件:strsafe.h

【API档案】版权归鱼C工作室(www.fishc.com)所有,转载请注明来源。


代码演示:
#include "strsafe.h"

......

TCHAR pszDest[30]; 
size_t cchDest = 30;

LPCTSTR pszFormat = TEXT("从你家到鱼C工作室需要 %f 公里!");

HRESULT hr = StringCchPrintf(pszDest, cchDest, pszFormat, 123.45);

......

想知道小甲鱼最近在做啥?请访问 -> ilovefishc.com
回复

使用道具 举报

发表于 2014-7-19 16:48:39 | 显示全部楼层
甲鱼 辛苦了O(∩_∩)O哈!
想知道小甲鱼最近在做啥?请访问 -> ilovefishc.com
回复 支持 1 反对 0

使用道具 举报

发表于 2014-7-19 17:58:26 | 显示全部楼层
支持了 。。。。。
想知道小甲鱼最近在做啥?请访问 -> ilovefishc.com
回复 支持 1 反对 0

使用道具 举报

发表于 2014-7-26 22:23:49 | 显示全部楼层
辛苦了
想知道小甲鱼最近在做啥?请访问 -> ilovefishc.com
回复 支持 1 反对 0

使用道具 举报

发表于 2014-8-6 01:18:04 | 显示全部楼层
1>8052.obj : error LNK2019: 无法解析的外部符号 _StringCchLength,该符号在函数 _WndProc@16 中被引用
1>8052.obj : error LNK2019: 无法解析的外部符号 _StringCchPrintf,该符号在函数 _WndProc@16 中被引用

请问坛主这是什么原因,我照你视频敲的。
想知道小甲鱼最近在做啥?请访问 -> ilovefishc.com
回复 支持 2 反对 0

使用道具 举报

发表于 2014-12-5 10:24:22 From FishC Mobile | 显示全部楼层
参数解析中cchDest第二条结束标记应为‘\0'吧?
想知道小甲鱼最近在做啥?请访问 -> ilovefishc.com
回复 支持 反对

使用道具 举报

发表于 2015-9-15 21:52:21 | 显示全部楼层
感谢小甲鱼老师
想知道小甲鱼最近在做啥?请访问 -> ilovefishc.com
回复 支持 反对

使用道具 举报

发表于 2016-3-26 15:17:57 | 显示全部楼层
cchDest的第二条,应设置得足够大,以容纳字符串和结束标记(' \n '),结束标记貌似应该是(' \0 ')吗?
想知道小甲鱼最近在做啥?请访问 -> ilovefishc.com
回复 支持 反对

使用道具 举报

发表于 2016-6-12 12:43:35 | 显示全部楼层
bevinilove 发表于 2014-8-6 01:18
1>8052.obj : error LNK2019: 无法解析的外部符号 _StringCchLength,该符号在函数 _WndProc@16 中被引用
...

解决了吗,怎么解决的?我也遇到这问题 了
想知道小甲鱼最近在做啥?请访问 -> ilovefishc.com
回复 支持 反对

使用道具 举报

发表于 2016-10-24 11:18:17 | 显示全部楼层
想知道小甲鱼最近在做啥?请访问 -> ilovefishc.com
回复

使用道具 举报

发表于 2016-10-26 12:26:44 | 显示全部楼层
想知道小甲鱼最近在做啥?请访问 -> ilovefishc.com
回复

使用道具 举报

发表于 2019-1-29 15:52:34 | 显示全部楼层
学习 努力
想知道小甲鱼最近在做啥?请访问 -> ilovefishc.com
回复 支持 反对

使用道具 举报

发表于 2023-5-6 23:50:02 | 显示全部楼层
想知道小甲鱼最近在做啥?请访问 -> ilovefishc.com
回复

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

小黑屋|手机版|Archiver|鱼C工作室 ( 粤ICP备18085999号-1 | 粤公网安备 44051102000585号)

GMT+8, 2024-11-18 00:47

Powered by Discuz! X3.4

© 2001-2023 Discuz! Team.

快速回复 返回顶部 返回列表