position指示了scintilla中的字符或字符前空白点的位置。第一个字符的position是0，第二个是1，依此类推。假如文档包含了nlen个字符，则最后一个字符的position是nlen – 1。光标存在于两个字符之间，能够被定位到第一个字符之前（0）和最后一个字符之后（nlen）。
当两个字符被当作一个字符处理时，光标是无法存在于两个字符之间的。这种情况，通常发生在中文等多字节字符或行结束符为crlf时。常量invalid_position（-1）表示一个非法位置。
出于性能考虑，所有文本行具有相同的高度：当前样式中最大字体的高度。
sci_gettext, sci_settext
1） sci_gettext(int length, char *text)
获取文本：
（1） 当text为0时，返回整个文档长度len + 1；
（2） 当length为0时，返回0；
（3） 当text不为0且length大于0时，返回length – 1，text被填充为从位置0开始的length – 1个字符和一个0终结符。如果length大于文档长度，多出的位置将被填充为空字符0。
unsigned int len = sendmessage(sci_gettext, 0, 0); char *chtext = new char[len]; sendmessage(sci_gettext, len, (lparam)chtext); … delete [] chtext;
2） sci_settext(<unused>, const char *text)
设置文档文本为text，text是以0结尾的常量字符串。如果text为0，返回false（0），否则返回true（1）。
sci_setsavepoint sci_setsavepoint
设置保存点，文档状态将变为unmodified，返回true（1）。sci_setsavepoint消息将会触发scn_savepointreached事件通知。当文档状态变为modified时，将会触发scn_savepointleft事件通知。
sci_getline
sci_getline(int line, char *text)
获取指定行文本，返回指定行文本长度（包括行结束符）。行号line从0开始，如果行号大于最大行号，将返回0。当text为0时，直接返回指定行文本长度；当text不为0时，text将被填充为指定行文本，但并不会自动设置结束符0。
unsigned int len = sendmessage(sci_getline, 1, 0); char *chtext = new char[len + 1]; memset(chtext, 0, len + 1);sendmessage(sci_getline, 1, (lparam)chtext); …delete [] chtext;
sci_replacesel
sci_replacesel(eb3ae17112958a950f284bf658cc0d85, const char *text)
替换选择文本，text是以0结尾的常量字符串。当没有文本被选择时，将在当前位置插入文本。替换后，光标将处于插入文本之后，并自动滚动视图，以使文本可见。当text为0时，返回false（0），否则返回true（1）。
sci_setreadonly, sci_getreadonly
1） sci_setreadonly(bool readonly)
设置文档为只读，返回true（1）。文档处于只读状态时，当文档发生修改，将会触发scn_modifyattemptro事件通知。
2） sci_getreadonly
获取文档只读状态，返回true（1）或false（0）。
sci_gettextrange
sci_gettextrange(eb3ae17112958a950f284bf658cc0d85, textrange *tr)
获取指定范围文本，如果tr为0，返回0，否则返回文本长度（不包括0终结符），并填充tr.lpstrtext为指定范围的文本和一个0终结符。当tr.chrg.cpmax为-1时，表示到文档结束位置。你必须确保tr.lpstrtext字符缓冲区足够大（(tr.chrg.cpmax - tr.chrg.cpmin) + 1）。
sci_getstyledtext
sci_getstyledtext(eb3ae17112958a950f284bf658cc0d85, textrange *tr)
获取指定范围样式文本，与sci_gettextrange类似，但所需字符缓冲区大小是sci_gettextrange的2倍（2 * (tr.chrg.cpmax - tr.chrg.cpmin) + 2）。scintilla将会自动追加2个0终结符到tr.lpstrtext尾部。
sci_allocate
sci_allocate(int bytes, eb3ae17112958a950f284bf658cc0d85)
分配足够大的缓冲区，以容纳指定大小的字节，返回true（1）。只有当指定大小大于当前缓冲区大小时，才会重新分配缓冲区，否则不做任何处理。
sci_addtext
sci_addtext(int length, const char *s)
在当前位置插入指定文本的指定长度，s是以0结尾的常量字符串，返回0。插入文本后，当前位置处于插入文本之后，但视图并不会自动进行滚动，以使其可见。
sci_addstyledtext
sci_addstyledtext(int length, cell *s)
在当前位置插入样式文本，处理方式和sci_addtext相似，返回0。
sci_appendtext
sci_appendtext(int length, const char *s)
在文档尾部插入文本，处理方式和sci_addtext相似，返回0。
sci_inserttext
sci_inserttext(int pos, const char *text)
在指定位置插入文本，处理方式和sci_addtext相似，返回0。当pos为-1时，表示在当前位置插入。
sci_clearall
sci_clearall
除非文档只读，否则删除文档所有字符，返回0。
sci_cleardocumentstyle
sci_cleardocumentstyle
清除文档所有样式信息，返回0。这通常用在需要重新设置文档样式的时候。
sci_getcharat
sci_getcharat(int position)
返回指定位置的字符。当position小于0或大于文档结束位置时，返回0。
sci_getstyleat
sci_getstyleat(int position)
返回指定位置的样式。当position小于0或大于文档结束位置时，返回0。
sci_setstylebits, sci_getstylebits
1） sci_setstylebits(int bits)
设置字节中样式位宽，返回true（1）。默认为5个bit，最大可以设置为7位，剩余的bit位将被用来表示字符指示器。
2） sci_getstylebits
返回字节中样式位宽。
sci_targetasutf8 *
sci_targetasutf8(eb3ae17112958a950f284bf658cc0d85, char *s)
将目标字符串转换为utf8编码格式，返回编码文本长度，并将编码后的字节填充到s中。此消息只在gtk+平台提供。
sci_encodedfromutf8 *
sci_encodedfromutf8(const char *utf8, char *encoded)
将utf8格式字符串转换为文档编码格式，返回转换后的字节长度，并将转换后的字节填充到encoded中。此消息只在gtk+平台提供。
sci_setlengthforencode
sci_setlengthforencode(int bytes)
设置文档编码长度，返回0。
以上就是scintilla使用指南(2) - 全文检索和修改的内容。