aardio 文档

win.rt.hString 库模块帮助文档

win.rt 成员列表

win.rt.hString

WinRT 字符串,
仅支持 Win10 以及 Win10 以上版本

创建 WinRT 字符串,
返回值可作为 tostring 参数转换为 aardio 字符串,
可用于调用 WinRT 函数的 HSTRING 类型句柄参数
也可以作为左操作数使用 + 或 ++ 操作符
与其他值拼接返回新的 win.rt.hString 对象

win.rt.hString()

创建空的 WinRT 字符串

返回对象:winRtHStringObject

win.rt.hString(HSTRING)

传入 HSTRING 指针,
复制此指针并返回新的 WinRT 字符串对象,
此类型参数构建的对象需要调用 free 函数释放

win.rt.hString(value)

传入任何非 null,pointer 类型参,
此函数自动调用 tostring 转换为字符串参数,
然后再创建并返回 WinRT 字符串,
如果传入非 null 值,则应尽早调用 free 函数释放字符串

win.rt.is()

判断输入值是否 win.rt.hString 对象

winRtHStringObject. 成员列表

winRtHStringObject..byStruct()

生成一个结构体,
用于在 API 中接收 HSTRING 类型的输出参数,
在 C++ 中该输出参数类型应为 HSTRING *,
在 aardio 中对应参数可声明为 struct &
或者免声明调用 API 并传入 byStruct 的返回值作为参数

当返回的结构体获取到 HSTRING 句柄后,
会立即更新调用 byStruct 成员函数的 win.rt.hString 对象,
在此之前会自动调用 free 函数释放之前可能需要释放的 HSTRING

通过 byStruct 获取到的 HSTING 未增加引用计数也不需要释放,
应立即通过 tostring 转换为 aardio 字符串或通过copy复制,
并调用 free 函数清空或直接弃用或置为 null 值

winRtHStringObject..copy()

复制并返回新的字符串,
复制的字符串应调用 free 函数释放

winRtHStringObject..free()

释放字符串,
即使不调用,回收该变量时也会自动调用此函数,
如果调用 win.rt.hString 传入了非 null 参数则应尽早调用此函数,
或者通过拼接、调用 copy 函数等创建新的 WinRT 字符串都应当调用此函数释放,
否则不必要调用此函数

winRtHStringObject..size()

字符串长度,按字符计数

Markdown 格式