StrMove - C++ Builder

C++ Builder 参考手册 ➙ System::Sysutils ➙ StrMove

---

复制字符串，源字符串内存区域与目标内存区域有重叠部分，也能得到正确的结果

头文件：#include
命名空间：System::Sysutils
函数原型：

char *__fastcall StrMove(char *Dest, const char *Source, unsigned Count);
System::WideChar *__fastcall StrMove(System::WideChar *Dest, const System::WideChar *Source, unsigned Count);

参数：

• Dest：把 Source 的内容复制到 Dest 里面；
• Source：把 Source 的内容复制到 Dest 里面；
• Count：复制的字符个数；

返回值：

• 把 Source 的内容复制到 Dest 里面 (Dest 内容被替换)，函数返回 Dest；
• Dest 字符串要有足够的内存储存 Source 的内容；
• 这个函数正好复制 Count 个字符，不会因为遇到结束符而停止，也不会在复制的内容之后加上结束符；
• 源字符串内存区域与目标内存区域有重叠部分，也能得到正确的结果，所以可以在字符串内部搬运一部分内容；
• 和 std::memmove, std::_fmemmove, std::_tmemmove, std::wmemmove, std::movmem, std::_fmovmem 的功能相同。

---

例1：

void __fastcall TForm1::Button1Click(TObject *Sender)
{
    wchar_t s[] = L"abcdefghijklmnopqrstuvwxyz";
    Memo1->Lines->Add(s);

    Sysutils::StrMove(s+4, s+2, 10);
    Memo1->Lines->Add(s);
}

运行结果：

运行结果

运行结果分析

---

例2：测试复制内容中间有结束符的情况：结束符之后的内容也会被复制，
字符串中间有一个结束符，直接显示字符串只显示结束符前面部分，
通过 t.cat_sprintf(L"%c",s[i]?s[i]:L'*'); 把结束符显示为 '*' 可以输出整个字符数组：

void __fastcall TForm1::Button1Click(TObject *Sender)
{
    wchar_t s[] = L"abcdefghijklmn\0pqrstuvwxyz";
    Memo1->Lines->Add(s);

    UnicodeString t;
    for(int i=0; i<26; i++)
        t.cat_sprintf(L"%c",s[i]?s[i]:L'*');
    Memo1->Lines->Add(t);

    Sysutils::StrMove(s+6, s+12, 10);
    Memo1->Lines->Add(s);

    t = L"";
    for(int i=0; i<26; i++)
        t.cat_sprintf(L"%c",s[i]?s[i]:L'*');
    Memo1->Lines->Add(t);
}

运行结果：

运行结果

运行结果分析

---

相关：

• System::Sysutils::StrAlloc
• System::Sysutils::StrBufSize
• System::Sysutils::StrCat
• System::Sysutils::StrComp
• System::Sysutils::StrCopy
• System::Sysutils::StrDispose
• System::Sysutils::StrECopy
• System::Sysutils::StrEnd
• System::Sysutils::StrIComp
• System::Sysutils::StrLCat
• System::Sysutils::StrLComp
• System::Sysutils::StrLCopy
• System::Sysutils::StrLen
• System::Sysutils::StrMove
• System::Sysutils::StrNew
• System::Sysutils::StrPCopy
• System::Sysutils::StrPLCopy
• System::Sysutils
• System::Move
• System::MoveChars
• System
• std::memmove, std::_fmemmove, std::_tmemmove, std::wmemmove, std::movmem, std::_fmovmem
• std::strcpy, std::_fstrcpy, std::_tcscpy, std::wcscpy

---

C++ Builder 参考手册 ➙ System::Sysutils ➙ StrMove