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

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

搜索标志                           说明
   

SCFIND_MATCHCASE   匹配大小写
   

SCFIND_WHOLEWORD   匹配整个单选
   

SCFIND_WORDSTART   匹配单词开始
   

SCFIND_REGEXP   正则表达式匹配
   

SCFIND_POSIX   POSIX兼容模式的正则表达式匹配（如使用(*)而不是/(*/)）
   

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

字符   说明
   

.   匹配任一字符
   

/(   分组匹配开始标记
   

/)   分组匹配结束标记
   

/n   n取值1 – 9，表示分组匹配的结果
   

/826ef2cecb965e210b7b4ae4c144e9bd   匹配单词结束
   

/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这样的字符序列。

以上就是Scintilla使用指南(3) - 搜索和替换的内容，更多相关内容请关注PHP中文网（www.php.cn）！