Scintilla使用指南(3) - 搜索和替换

Scintilla提供了搜索和替换功能，它可以进行普通查找和正则表达式查找。Scintilla的正则表达式，只提供了很有限的一些基本功能。
在进行文本搜索时，需要设置搜索标志：

搜索标志	说明
SCFIND_MATCHCASE	匹配大小写
SCFIND_WHOLEWORD	匹配整个单选
SCFIND_WORDSTART	匹配单词开始
SCFIND_REGEXP	正则表达式匹配
SCFIND_POSIX	POSIX兼容模式的正则表达式匹配（如使用(*)而不是/(*/)）

在非正则表达式模式下，当end小于start时，可以向上反向搜索；在正则表达式模式下，只能向下正向搜索。
在正则表达式中，有一些特殊字符：

字符	说明
.	匹配任一字符
/(	分组匹配开始标记
/)	分组匹配结束标记
/n	n取值1 – 9，表示分组匹配的结果
/<	匹配单词开始
/>	匹配单词结束
/x	x将被解释为普通字符，例如：/[被解释为字符[
[…]	匹配[]中的任一字符，如[a-zA-Z]匹配任一字母
[^…]	匹配不在[]中的任一字符
^	匹配行开始
$	匹配行结束
*	匹配0次或多次
+	匹配1次或多次

SCI_FINDTEXT

SCI_FINDTEXT(int flags, TextToFind *ttf)
根据搜索标志flags搜索文本。如果找到，返回匹配文本的开始位置,并设置ttf.chrgText.cpMin和ttf.chrgText.cpMax为匹配文本的开始位置和结束位置，否则返回-1。SCI_FINDTEXT不会改变当前的选择信息。

int flags = SCFIND_MATCHCASE | SCFIND_WHOLEWORD; TextToFind ttf; ttf.chrg.cpMin = 0; ttf.chrg.cpMax = SendMessage(SCI_GETLENGTH, 0, 0); ttf.lpstrText = "search text"; int pos = SendMessage(SCI_FINDTEXT, flags, (LPARAM)&ttf); if (-1 != pos) { ... }

SCI_SEARCHANCHOR

SCI_SEARCHANCHOR
设置搜索anchor位置为当前选择信息中靠近文档开始的位置，返回TRUE（1）。这个消息，通常用在调用SCI_SEARCHNEXT或SCI_SEARCHPREV之前。如果宏记录功能打开，SCI_SEARCHANCHOR消息将会触发SCN_MACRORECORD事件通知。

int flags = SCFIND_MATCHCASE | SCFIND_WHOLEWORD; char *chText = "search text"; SendMessage(SCI_SEARCHANCHOR, 0, 0); SendMessage(SCI_SEARCHNEXT, flags, (LPARAM)chText);

SCI_SEARCHNEXT

SCI_SEARCHNEXT(int searchFlags, const char *text)
从anchor位置向下开始搜索指定文本（结束位置为文档结尾），如果找到，选中匹配文本，返回匹配文本的开始位置，否则返回-1。在使用SCI_SEARCHNEXT之前，通常会调用SCI_SEARCHANCHOR设置anchor位置。SCI_SEARCHNEXT消息不会导致视图发生滚动，并且光标处于靠近文档开始的一边。如果宏记录功能打开，SCI_SEARCHNEXT消息将会触发SCN_MACRORECORD事件通知。

SCI_SEARCHPREV

SCI_SEARCHPREV(int searchFlags, const char *text)
从anchor位置向上开始搜索指定文本（结束位置为文档开始），如果找到，选中匹配文本，返回匹配文本的开始位置，否则返回-1。在使用SCI_SEARCHPREV之前，通常会调用SCI_SEARCHANCHOR设置anchor位置。SCI_SEARCHPREV消息不会导致视图发生滚动，并且光标处于靠近文档开始的一边。如果宏记录功能打开，SCI_SEARCHPREV消息将会触发SCN_MACRORECORD事件通知。

SCI_SETTARGETSTART, SCI_GETTARGETSTART

1） SCI_SETTARGETSTART(int pos)
设置搜索开始位置，返回TRUE（1）。在非正则表达式模式下，你可以设置开始位置大于结束位置，进行反向搜索。
2） SCI_GETTARGETSTART
返回搜索开始位置。

SCI_SETTARGETEND, SCI_GETTARGETEND

1） SCI_SETTARGETEND(int pos)
设置搜索结束位置，返回TRUE（1）。
2） SCI_GETTARGETEND
返回搜索结束位置。

SCI_TARGETFROMSELECTION

SCI_TARGETFROMSELECTION
根据当前选择消息，设置搜索开始位置和结束位置，返回TRUE（1）。

SCI_SETSEARCHFLAGS, SCI_GETSEARCHFLAGS

1） SCI_SETSEARCHFLAGS(int searchFlags)
设置搜索标志，返回TRUE（1）。
2） SCI_GETSEARCHFLAGS
返回搜索标志。

SCI_SEARCHINTARGET

SCI_SEARCHINTARGET(int length, const char *text)
根据SCI_SETTARGETSTART、SCI_SETTARGETEND、SCI_SETSEARCHFLAGS等设置的信息，搜索指定文本。如果找到，返回匹配文本的开始位置，否则返回-1。text不必以0终结符结尾，其搜索文本长度由参数length指定。

SCI_REPLACETARGET

SCI_REPLACETARGET(int length, const char *text)
根据SCI_SETTARGETSTART、SCI_SETTARGETEND设置的信息，替换文本。如果length为-1，则text是以0终结符结尾的常量字符串，返回text的长度；否则，text不必以0终结符结尾，替换文本长度由参数length指定，返回length。替换文本后，光标将位于替换文本靠近文档开始的一边。
如果要删除一段文本，可以用空字符串进行替换。

SCI_REPLACETARGETRE

SCI_REPLACETARGETRE(int length, const char *text)
与SCI_REPLACETARGET相似，不同的是使用正则表达式替换文本。在text中，可以包含/1 - /9这样的字符序列，最后生成的替换文本中，将用上一次正则表达式搜索匹配结果，替换/1 - /9这样的字符序列。