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

àì夳堔傛蜴生んèń 2022-05-15 19:48 285阅读 0赞

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

本文来自[http://blog.csdn.net/jack\_china2008/archive/2008/06/10/2530388.aspx][http_blog.csdn.net_jack_china2008_archive_2008_06_10_2530388.aspx]

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

[http_blog.csdn.net_jack_china2008_archive_2008_06_10_2530388.aspx]: http://blog.csdn.net/jack_china2008/archive/2008/06/10/2530388.aspx