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

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