StrNew - C++ Builder
2022-04-08 本文已影响0人
玄坴
C++ Builder 参考手册 ➙ System::Sysutils ➙ StrNew
使用 StrAlloc 分配内存并且把字符串复制到这里
头文件:#include <System.SysUtils.hpp>
命名空间:System::Sysutils
函数原型:
char *__fastcall StrNew(const char *Str);
System::WideChar *__fastcall StrNew(const System::WideChar *Str);
参数:
- Str: 要复制的字符串
返回值:
- 使用 StrAlloc 或 AnsiStrAlloc 分配一个 Delphi 兼容的字符串内存,然后把字符串 Str 复制到分配的内存,函数返回指向新分配内存里面字符串的指针;
- 如果参数 Str 等于 nullptr,函数直接返回 nullptr;
- 如果要释放这个函数分配的内存,需要使用 StrDispose 函数;
- 可以通过函数 StrLen 获取字符串长度;
- 可以通过函数 StrBufSize 获取内存里面可以存放的字节数,即分配内存时调用 StrAlloc 或 AnsiStrAlloc 的参数值;
- 实际分配内存的字节数等于 Str 字符串长度 + 结束符 + 4个字节 占用的内存,有关分配内存的详细说明请参考 StrAlloc 和 AnsiStrAlloc。
例子:请参考 StrLen 和 StrBufSize 的例子。
相关:
- System::Sysutils::StrAlloc
- System::Sysutils::AnsiStrAlloc
- System::Sysutils::WideStrAlloc
- System::Sysutils::StrBufSize
- System::Sysutils::StrLen
- System::Sysutils::StrNew
- System::Sysutils::StrDispose
- System::Sysutils
- System::UnicodeString
- System::StringOfChar
- System
- std::malloc
- std::calloc
- std::realloc
- std::free
- <cstdlib>
C++ Builder 参考手册 ➙ System::Sysutils ➙ StrNew