WrapText - C++ Builder

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

---

把字符串按照参数的规则插入换行，变成多行文字

头文件：#include <System.SysUtils.hpp>
命名空间：System::Sysutils
函数原型：

System::UnicodeString __fastcall WrapText(
    const System::UnicodeString Line,
    const System::UnicodeString BreakStr,
    const TSysCharSet &BreakChars,
    int MaxCol);

System::UnicodeString __fastcall WrapText(
    const System::UnicodeString Line,
    int MaxCol = 45);

参数：

• Line：要处理的字符串；
• BreakStr：换行符字符串；
• BreakChars：允许在这些字符后面插入换行符字符串，但是在单引号或双引号内的字符不处理；
• MaxCol：每行文字的最大长度，在这个长度之内的最后一个 BreakChars 的后面换行；

返回值：

• 在字符串 Line 里面加入换行符字符串的多行文字；
• 如果没有 BreakStr 参数，使用 System.hpp 里面的 sLineBreak，
  在 Windows 里面是 "\r\n"，其他系统里面是 "\n"；
• 如果没有 BreakChars 参数，使用空格 ' '，减号 '-'，制表符 '\t'，
  即 TSysCharSet() << L' ' << L'-' << L'\t'。

---

例子：

void __fastcall TForm1::Button1Click(TObject *Sender)
{
    Memo1->Text = WrapText(
        L"The rain in Spain falls mainly on the plain.",
        L"\r\n",
        TSysCharSet() << L'.' << L' ' << L'\t' << L'-',
        15);
}

运行结果

---

相关：

• System::Sysutils::AnsiPos
• System::Sysutils::AnsiStrPos
• System::Sysutils::StrPos
• System::Sysutils::TextPos
• System::Sysutils::StrScan
• System::Sysutils::StrRScan
• System::Sysutils::AnsiStrScan
• System::Sysutils::AnsiStrRScan
• System::Sysutils::AnsiLastChar
• System::Sysutils::AnsiStrLastChar
• System::Sysutils::NextCharIndex
• System::Sysutils::FindDelimiter
• System::Sysutils::IsDelimiter
• System::Sysutils::LastDelimiter
• System::Sysutils
• std::strstr, std::_fstrstr, std::_tcsstr, std::wcsstr
• std::strchr, std::_fstrchr, std::_tcschr, std::wcschr
• std::strrchr, std::_fstrrchr, std::_tcsrchr, std::wcsrchr
• std::_strspnp, std::_tcsspnp, std::_wcsspnp
• std::strcspn, std::_fstrcspn, std::_tcscspn, std::wcscspn
• std::strtok, std::_fstrtok, std::_tcstok, std::wcstok
• <cstring>

---

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