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

搜索标志 说明

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

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