Source Insight

Source Insight Marco研究（语法篇）

Source Insight Marco研究（语法篇）

Source Insight宏语法与C相似，编写好的宏以.em文件存储。要使用宏先需要把.em文件加入到当前工程或是Base工程中，然后为其分配一个快捷键或是菜单项，之后就可以使用键盘或是点击菜单来调用宏。

si的宏语法“不是”大小写敏感的，且每行语句不强制要求以分号结束，语法元素之间的空格将被自动忽略，变量名必须以字母开头。

1. 宏定义方法如下，可以传递参数，可以有返回值，但和一些脚本语言一样，在si宏中没有数据类型一说。
macro my_macro(a, b, c)
{
    ...
   
    return a+b+c
}

2. 以下代码展示了si宏的控制语句，学过C语言的人都可以很快上手。
while (条件)
{
    if (条件)
    {
        ...
        break
    }
    else
    {
        continue
    }
   
    return 0
}

3. 以下代码展示了变量的定义
macro SomeFunction()
{
    var localx                           //定义局部变量，局部变量可以不定义而直接使用
    global globalvariables;        //定义全局变量
   
    localx = 1;                            //局部变量赋值，作用域是当前macro
    globalvariables = "ison81"    //全局变量赋值，作用域是整个si，其它macro也可以访问
}

 

4. 以下代码展示了关于变量和数据类型的一些注意事项，

 

a. 空串

｛
    S = nil // s is set to the empty string
    S = ""  // same as nil
｝

b. 在变量中展开字符串，使用@...@
S = “Hey, @username@, don’t break the build again!”

c. 字符串当成数字来运算
s = "1"
x = s + 2    // x now contains the string "3"
y = 2 * x + 5 // x now contains "11"
但这样就是错的，
s = "hello"
x = s + 1 // error
如果要灵活，可以先检测一个字符串是不是数字，
if (IsNumber(x))
    x = x / 4   // okay to do arithmetic

d. 引用字符串中的字符，
s = "abc"
x = s[0]    // x now contains the string "a"
si的字符串也是zero-terminated，
s = "abc"
length = strlen(s)
ch = s[length] // ch now contains the empty string
if (ch == "")
    msg "End of string."

5. 关于结构体

定义
Rec = nil  // initializes as an empty string
Rec.name = “Joe Smith”
Rec.age = “34”
Rec.experience = “guru”
另一种定义方法，
rec = “name=\”Joe Smith\”;age=\”34\”;experience=\”guru\””

引用结构体
Filename = slr.file  // get file field of slr
LineNumber = slr.lnFirst  // get lnFirst field of slr

6. 关于数组

si宏并没有提供数组的概念，数组是通过buf来模拟实现的，关于buf还是在介绍macro API时再讨论。

7. 运算符

.加减乘除（+, -, *, /）
.逻辑(&&, ||, !)
.自增自减(++, --)，可前可后
.算术比较（>, <, >=, <=, ==, !=）

.字符串比较(==, !=)
.字符串连接(#)与引用(@...@)

22:02 | 固定链接 | source insight

source insight研究——正则表达式篇

source insight研究——正则表达式篇

正则表达式主要用来做搜索和替换，一般强大一点的编辑器都会支持。si在搜索和替换界面里都有Use Regular Expression这样的选项。个人认为使用正则表达式(后简称RE)应该是每个程序员都应该掌握的技能。虽然和vim这些相比si对RE的支持还是弱一点，但对于从未了解过RE的人来说，从si这样的编辑器来入门RE也不失为一个好的选择。

学习任何一项科学或技术，了解其涉及的各种概念是第一步，也是比较花时间的一步，我们需要先通读达到大概了解，再实践，在实践中去理解，然后再总结，得出自己的结论，把书本变薄。

RE中的主要概念就是一堆通配符。通配符可以分为两类，一种是表内容的，一种是表数量的。

表内容的如：
.      任意字符
[abc]    任何在[]之内的字符
[^abc]  任何不在[]之内的字符，^表示不在[]之内
还有一些就是转义字符了如\t(tab), \s(space), \w(tab or space)

表数量的如：
* 大于等于0个
+ 大于0个，也就是至少有1个

其它如：
^    表示行起始，注意不要把这个^和[]里的^搞混了。
$    表示行的结束

要说明的是，不同的工具对RE的支持不太一样，比如强一点的工具支持的通配符可能会多一点，转义字符的定义也可能不一样等等。

举个例子理解一下吧，

.*    这条RE可以匹配任意的字符串序列，因为.表示任意字符，*表示大于等于0个，连起来理解就是“任意个任意字符”
[abc]+  表示“a或b或c出现1次或多次”，像字符串abc, cbac, aacbcb，aaaaa都被可以匹配

如果还不是很理解可以用si的搜索功能自己实践一下。

在理解上面的基础之上就可以使用RE进行替换了，替换和搜索没有什么不同，比如你可以将"[abc]+"替换成"abc"，但如果仅仅是这样就没有什么意思了。替换里和RE相关的内容是分组。与分组有关的概念包括：

1. 一个分组以开始，以结束
2. 一个RE中可以有多个分组
3. 引用一个分组使用\1, \2, \3, ...

还是举个例子吧，假设我们的代码中有个函数叫func，它的原型定义如下

void func(int var1, int var2)

某天我心血来潮，把func的原型修改成了，

void func(int var2, int var1)，

如果没有RE，这下子可就麻烦了，所有调用func的地方都要手工挨个修改，好在有RE。按下Ctrl+h，选择使用RE进行替换，在Old中输入"func(.∗, .∗)"，在New中输入"func(\2, \1)"，然后执行，你会发现全部搞定了。

当然ctrl+h只能在本文件中搜索替换，要想替换整个工程的，可以使用ctrl+shift+h。

22:01 | 固定链接 | source insight

source insight研究——快捷键篇（转）

source insight研究——快捷键篇

http://blog.csdn.net/ison81/archive/2008/12/13/3510426.aspx

关于键盘和鼠标谁更快捷之争，是一个永远被程序员争论的话题。我想大多数人都不会极端的信奉一种操作方式，鼠标更为大众接受，但掌握一些快捷键对于提高操作速度是有帮助的。

si为我们提供了丰富的快捷键和灵活的定制方式，同时还支持自定义命令和脚本，熟练掌握这些之后相信可以使你更加喜欢它。

以下是我认为比较有用的快捷键：

1. ctrl+o，打开文件列表
2. F7，打开符号检索窗口（全局列表）
3. F8，打开符号检索窗口（本地文件）
4. ctrl+=，调转到符号的定义处
5. alt+, /alt+. 跳转到前/后一次停留的地方
7. ctrl+/，全局搜索
8. ctrl+'，搜索并替换
9. shift+f8，把当前光标下的关键字标记为高亮

另外常用的ctrl+c, ctrl+v这些就不说了，但是si很别扭的是把ctrl+a设置为save all还不是select all，的确我承认前者可能比后者使用频率更高，但谁让我们已经被windows惯坏了呢？

更让人奇怪的是，我这个最新的si居然不能在Key Assignments中找到Select All命令。这样就不能把ctrl+a设置成Select All了。真的这样吗？其实还有一个万能招，就是用si的宏自己写一个select all出来，这并不难，但也不容易，主要是要学习一下它内建的那些个api，这里并不想讨论怎么写宏，还是另找别处吧。好了，select all的写法如下：

macro SelectAll()
{
    hwnd = GetCurrentWnd();
    hbuf = GetCurrentBuf();
    selrec = GetWndSel(hwnd);
    selrec.lnFirst = 0;
    selrec.ichFirst = 0;
    selrec.lnLast = GetBufLineCount(hbuf);
    selrec.ichLim = 0;
    selrec.fExtended = TRUE;
    selrec.fRect = FALSE;
    SetWndSel(hwnd, selrec);
}


我比较反对把快捷键的设置改得太多，如果没有必要最好还是保持系统原设，这样当你在别的机器上操作时也不致于太陌生。

最后附上我的si布局，还有配色。

21:59 | 阅读评论 (1) | 固定链接 | source insight

source insight研究——配置篇(转)

source insight研究——配置篇

http://blog.csdn.net/ison81/archive/2008/12/13/3510043.aspx

用si有好几年了，零零散散也累积了不少心得，但总觉得还有一些内容是不知道的，所以今天干脆来个大清扫，把所有的选项都研究一遍，并把自认为有用的内容在这里整理一下。

si的主要配置都在Options->Perferences菜单里，

1、General

Project File Synchronization->Remove missing file from project选上可以避免因文件找不到而弹出错误对话框。

把Misc->Use stricter confirmation dialog选项去掉可以使确认时不输入"yes"。

2、Typing

Source Editing->Indent commands affect #-preprocessor statements。去掉后（默认值），进行多行缩进时不会影响预处理语句（如#if...#endif）。

Auto Completion->Use detailed completion window，选上后，联想时可以出现该函数的详细信息。见下图：

 （简单）

 （详细）


Auto Completion->Insert paremeters for functions，去掉后，自动联想不会把整个参数都输出到当前行。

Browsing in Lists->Match syllables while typing(slower)。在symbol list框检索符号时是否采用音节匹配方式，如对于函数FindNext，输入find或者next都可以找到该函数。该功能可能导致反应缓慢（视工程和机器配置而定），建议关闭，因为即使在关闭状态下也可以通过先输入空格再输入单词来动态启用该功能。

注意Browsing in Lists里其实有两个功能，但一般我们只能看到Match syllables while typing这一条，应该是si的菜单设计没有做好，导致在中文windows下不能显示全，另一个功能是Match members while typing，用于打开/关闭按成员变量名来检索类/结构体的功能。

3、Files

Opening Files->Sharing: Let other programs modify files，以共享方式打开文件，这个很重要，保证可以在其它编辑中同时编辑该文件。典型的场景就是用ide环境去动态编译调试，而用si静态阅读。

Customize 'Open' Command...，用于设置Ctrl+O打开的页面，默认选项是 Project File list view in Project Window，建议保持默认。

Saving Files->Preserve Undo data and revision marks after saving，如果发现保存后就不能undo了，请检查该选项是否选中。

Remove extra white space when saving。保存时自动去除每行尾部的空格和tab。建议选中。

4、Languages

自定义其它编程语言的语法解析，这个...还是另写一篇来讲吧。

Conditional Parsing不要错过了，这里的Conditions功能实在让人喜欢。Conditions是什么意思呢？我们的代码中一般都会有一些开关宏，通过在Conditions中配置这些宏的默认值，可以让si把配置为不开启的宏视为无效代码，从而不进行符号检索。

如果源代码中的开关宏太多，还可以使用Condition Parsing中的Scan Files来自动找出所有开关宏。

5、Symbol Lookups

没太多特别的。

6、Display

显示配置和个人喜好和显示器的状态有关，偶用的x60小本，屏幕资源有限，所以在Display Elements里把Project Window, Status Bar, Tool Bar，Clip Window都关了，基本用快捷键可以代替它们。

Options->Horizontal scroll bars for each new window。很多大师都教导我们说一行不要写太多代码。在这个指导思想下，我们不需要这个东东。

Show exact case of file names。如果看不惯si把所有的文件名首字母都大写就勾上这个选项吧。

Tile source and destination windows for Source Link commands。Source Link很多时候用于外部命令输出结果的解析（如Make, lint），这个功能会把解析结果与目标窗口自动tile，很实用。

Trim long path names with ellipses。这个建议不要选中。事实上这个主要影响标题栏，但一般来说标题栏上的空间是充裕的，选上之后往往会令我们不知道所编辑文件的具体位置。

7、Color

这个不用多说了。自己怎么喜欢怎么配吧。

8、Syntax Formatting

如果让大家说出喜欢si的几个理由，我想语法着色一定会是其中之一。

Basics->Use only color formatting。只启用style中关于颜色的设置。其它如粗体、斜体、阴影等都不启用。

Apply Styles for Lanugage Elements。把分类启用style，都选上吧。

Symbol Reference Lookups->Qualify references to members。检测成员的有效性，如果不是类/结构体中的一部分，则不启用style。虽然可能导致性能降低，但还是建议打开。同样Qualify references to functions也是。

这里有个按钮可以进入Doc Types页面（Options菜单也可以进入），里面有很多重要选项：

Editing Options中，

Expand tabs, Visible tabs可以帮助我们发现并转换tab。
Show right margint和Margin width可以提醒我们是否把一行写得太长。
Symbol Window选项建议关闭（因为有快捷键）。

Auto Indent对话框中，
如果没有特别喜好，建议把Smart Indent Options的两个勾都去掉。同时Auto Indent Type选Smart。

9、Syntax Decorations

可以把一些符号转换成特殊形式显示，如->转换成→。如果要使用该功能，不能开启Syntax Formatting->Basics->Use only color formatting。

Auto annotations下的三个功能都比较有用，

Show arrows at goto statements可以在goto时显示一个向上或向下的箭头，表示是向上goto还是向下goto。不过我们还是尽量不要用goto了。

Annotate closing braces with end-statement。在"}"后显示标识，表示该"}"与哪个if/switch配对。而下面的Annotate closing braces only for long blocks则是一个补充选项，表示只在较长的语句块时才显示标识。

10、Searching

没什么特别的，注意Automatically load selection into Find pattern。

11、Remote

与远程登录相关的一些选项。可以提高远程使用的显示性能。

12、Folders

没什么特别的。


最后简单说下si的配置文件。可以通过Options->Load Configuration/Save Configuration来导入/导出配置，可以导出全部，也可以导出某几个部分（如style）。si的配置有两级，一是全局配置，一是项目配置。出入方便考虑，统一一个配置就好了，在创建项目时选择用全局配置（默认值）。

导入配置也可以通过双击配置文件来完成。

21:57 | 固定链接 | source insight

3月10日

（转）Source Insight使用技巧

http://wz.csdn.net/url/1304282/

 

1、背景色选择
要改变背景色Options->preference->windows background->color设置背景色
2、解决字符等宽对齐问题。
SIS默认字体是VERDANA，很漂亮。这网页上应该也是用的VERDANA字体。但由于美观的缘故，VERDANA字体是不等宽的。比如下面两行
llllllllll
MMMMMMMMMM
同样10个字符，长度差多了.用VERDANA来看程序，有些本应该对齐的就歪了。解放方法是使用等宽的字体，但肯定比较丑。比较推荐的是用Courier New。
3、解决TAB键缩进问题
Options-> Document Options里面的右下角Editing Options栏里，把Expand tabs勾起来，然后确定。OK，现在TAB键的缩进和四个空格的缩进在SIS里面看起来就对齐咯

4、SI中的自动对齐设置:
在C程序里, 如果遇到行末没有分号的语句,如IF, WHILE, SWITCH等, 写到该行末按回车，则新行自动相对上一行缩进两列。
Option->Document option下的Auto Indient中Auto Indient Type有三种类型 None,Simple,Smart。个人推荐选用Simple类型。
5、向项目中添加文件时，只添加特定类型的文件（文件类型过滤器）
编辑汇编代码时，在SIS里建立PROJECT并ADD TREE的时候，根据默认设置并不会把该TREE里面所有汇编文件都包含进来
只加了.inc和.asm后缀的，.s后缀的没有。而且用SIS打开.s的文件，一片黑白没有色彩，感觉回到DOS的EDIT时代了……
解决方法是在Options->Document Options里面，点左上的Document Type下拉菜单，选择x86 Asm Source File，
然后在右边的File filter里*.asm；*.inc；的后面加上*.s；接着CLOSE就可以了。
上面问题解决了，但注意加入*.s后还需要重新ADD TREE一遍才能把这些汇编加到PROJECT里面。
6、添加文件类型
用户可以定义自己的类型，Options->Document Options->add type,定义文件类型名以及文件名后缀。
勾选include when adding to projects在添加目录下文件到工程是该类文件就会添加进SI的工程。
如果需要将所有文件添加进SI的工程，可以定义一种文件类型*.*。
7、恢复ctrl+a的全选功能
通过关键词save 找到save all，更改为ctrl+shift+a，通过关键词select找到select all，更改为ctrl +a


Source Insight常用的快捷键：
Ctrl+= :Jump to definition
Alt+/ :Look up reference
F3 : search backward
F4 : search forward
F5: go to Line
F7 :Look up symbols
F8 :Look up local symbols
F9 :Ident left
F10 :Ident right
Alt+, :Jump backword
Alt+. : Jump forward
Shift+F3 : search the word under cusor backward
Shift+F4 : search the word under cusor forward
F12 : incremental search
Shift+Ctrl+f: search in project
shift+F8 : hilight word

Source Insight的窗口操作:
project window Ctrl+O打开
symbol window Alt+F8打开和关闭
Contex Window 自定义键打开和关闭
Relation Window 自定义键打开　先锁定再刷新联系

在Source Insight中添加自定义功能的步骤如下：
1.Source Insight中,Options->Custom Commands...->Add...,New Command name 随便写,我的是"Edit with Vim"
2.Run中写入: "C:\Program Files\Vim\vim63\gvim.exe" --remote-silent +%l %f
意思是在当前已经打开的gvim窗口里面打开当前的文件,并且跳转到指定行
%l为当前的行号,%f为文件名
使用 --remote-silent 的作用是,如果已经打开了对应文件,就不会打开第二次,而是在已经打开的文件里跳转到对应行
3.还是同一个对话框里面,选择Keys->Assign New Key...->按F12,如果你已经将F12设置给其他命令,选择其他的按键就行了

下面是一些常用自定义功能：( CUSTOM COMMANDS )

打开资源管理器并选中当前文件
ShellExecute open explorer /e,/select,%f
查看log
"C:\Program Files\TortoiseSVN\bin\TortoiseProc.exe" /command:log /path:%f /notempfile /closeonend
diff
"C:\Program Files\TortoiseSVN\bin\TortoiseProc.exe" /command:diff /path:%f /notempfile /closeonend
取得锁定(check out)
"C:\Program Files\TortoiseSVN\bin\TortoiseProc.exe" /command:lock /path:%f /notempfile /closeonend
提交（check in）
"C:\Program Files\TortoiseSVN\bin\TortoiseProc.exe" /command:commit /path:%f /notempfile /closeonend
更新（update）
"C:\Program Files\TortoiseSVN\bin\TortoiseProc.exe" /command:update /path:%f /notempfile /closeonend
更新整个目录（update all）
"C:\Program Files\TortoiseSVN\bin\TortoiseProc.exe" /command:update /path:*.* /notempfile /closeonend
取消锁定（undo check out）
"C:\Program Files\TortoiseSVN\bin\TortoiseProc.exe" /command:revert /path:%f /notempfile /closeonend
在ultriEdit中编辑
"C:\Program Files\UltraEdit-32/uedit32" %f
在vim中编辑并定位到当前行
"C:\Program Files\Vim\vim63\gvim.exe" --remote-silent +%l %f

汇总其他小技巧：

让{ 和 } 不缩进：

Options->Document Options->Auto Indent->Indent Open Brace/Indent Close Brace

hao space: SourceInsight 小技巧
1、按住"ctrl", 再用鼠标指向某个变量，点击一下，就能进入这个变量的定义。

2、今天把一个用sourceinsight排版整齐的C文件，偶然用VC打开一看，全乱了。研究了半天，发现SI对每个字符的宽度不太一致。
请教同事发现选上"view --> draft view"， 就可以让每个字符的宽度一致了。快捷键是 "Alt + F12"

3、"shift+F8" 标亮所有文本中光标所在位置的单词

4、跳到某一行："ctrl + g"

Source Insight是阅读和编写代码的好东东，基本上也算得上是经典之作了，虽然还有一点点小bug，不过对于我们这些C程序员来说可是一旦拥有别无所求。下列小技巧是在工作中同事整理总结的，对提高工作效率多少有点帮助，其中有些是对应于SVN的，没有使用SVN做版本管理的人就不要白费力气了。

ShellExecute open explorer /e,/select,%f



X:\Progra~1\TortoiseSVN\bin\TortoiseProc.exe /command:log /path:% /notempfile /closeonend




X:\Progra~1\TortoiseSVN\bin\TortoiseProc.exe /command:diff /path:% /notempfile /closeonend




Source Insight中的文件过滤器

遇到在新建工程的时候，需要加入一些除了.c .h 等之外的文件，比如.s，.scf ，Makefile和ReleaseNotes等文件，而每次新建工程的时候，即使取消了shown only known document types,和在点击Add All之后选择了Recusively add lower sub-directories ，也还是不能正常识别这类文件，也就不能加入进工程，只能我们自己手动双击添加到工程中，如果文件少还无所谓，但是包含了很多子文件夹的大工程，这样实在不可行。

百度了下，终于发现解决办法了：

打开Source Insight，在新建工程之前，进入

Options -> Document Options... Alt-T -> 点击Document Type的下拉框，然后选择Make File，在右边的File Filter中，在原先的*.mak后面加上一个分号，即多个不同过滤规则以分号间隔开，再加上*makefile，变成 *.mak;*makefile，并且选中Include when adding to projects,这样，以后再新建工程的时候，就可以识别makefile或Makefile了（好像此处Source Insight并不区分大小写）。

类似的原理，给其他你想要加入的不同的类型的文件，分别加入到原先的一些文件类型后面，注意要用分号隔开，或者直接新建一个文件类型，然后写上对应的顾虑规则，比如

点击 Add Type，填入新文件类型的名字Scatter File，File Filter中写上*.scf，注意再选中下面的Include when adding to projects,这样就建立了一个新的文件类型， 以后新建工程加入文件时候，系统就能够识别后缀是scf的文件了。