AutoCAD的Diesel语言函数详解及示例解读
著作权归作者所有，任何形式的转载都请联系作者。
在AutoCAD中，DIESEL是Direct Interpretively Evaluated String Expression Language（直接解释求值字符串表达式语言）的缩写，它是一种宏语言，今天隆重推荐。本人多年以前在研究AutoCAD的菜单文件时，看到菜单中有“$”开头的字符串，不明所以，也未进一步研究，直到前段时间研究Diesel语言才终于明白就是它。对于大多数一般AutoCAD使用者而言，Diesel语言相当陌生。实际上，对于能够在字段、菜单和按钮等位置灵活运用Diesel表达式的设计人员而言，将带来很大的便利。
在Diesel表达式中，'$()'告诉AutoCAD，括号中包含的以下字符串需要由Diesel解释器进行评估。"$"是CAD中Diesel语言形成的宏的标记，而后面的"()"则是表达式语言的标记，跟AutoLisp一样，操作符前置。Diesel表达式也可以嵌套。它可以在菜单、按钮中应用，也可以在“字段”中应用，还可以用来修改状态行。
Diesel 表达式的函数、错误消息以及应用具体介绍如下，也可以参见Autodesk Knowledge Network官网（虽然为中文，但注意是机器翻译）：
所有的函数最多只能包含 10 个参数，包括函数名本身。函数基本形式为：$(函数名, 参数1, 参数2, …, 参数9)。参数若含“[ ]”，说明参数可选。
1、四则运算
四则运算包括＋（加）、-（减）、*（乘）、/（除）4种。
$(+, val1 [, val2, …, val9]) ，返回数字 val1 、 val2 、…、 val9 的和。
$(-, val1 [, val2, …, val9]) ，返回数字 val1 减去 val2 、…、 val9 的结果。
$(*, val1 [, val2, …, val9]) ，返回数字 val1 、 val2 、…、 val9 的积。
$(/, val1 [, val2, …, val9]) ，返回数字 val1 除以 val2 、…、 val9 的结果。
2、比较运算
比较运算符包括 =（等于）、<（小于）、>（大于）、!=（不等于）、<=（小于或等于）、>=（大于或等于）6种。所有比较运算函数形式均相同，参数个数均为2个，结果为真，返回1，否则返回0。如 $(!=, val1, val2) ，如果数字 val1 和 val2 不相等，则字符串返回 1；否则，返回 0。
3、逻辑运算
逻辑运算符包括and（与）、or（或）、xor（异或）3种。所有逻辑运算函数形式均相同，参数均为整数，最多可以有9个参数。如 $(xor, val1 [, val2,…, val9])，返回整数 val1 到 val9 的按位逻辑异或。
4、函数
函数包括 angtos、edtime、eq、eval、fix、getenv、getvar、if、index、nth、rtos、strlen、substr、upper 等14个。具体说明如下：
$(angtos,value[,mode,precision]) 按指定的格式和精度返回角度值。可应用以下 mode值：0（表示度）、1（表示度/分/秒）、2（表示百分度）、3（表示弧度）、4（表示勘测单位）。
$(edtime, time, picture) 返回基，于指定图片的格式化的日期和时间。
$(eq, val1, val2) 如果字符串 val1 和 val2 相同，则字符串返回 1；否则，返回 0。
$(eval,str) 将字符串 str 传给 DIESEL 计算器，并返回计算结果。
$(fix, value) 通过舍弃小数部分，将实数数字值 截断为整数。
$(getenv, varname) 返回环境变量 varname 的值。
$(getvar, varname) 返回具有给定 varname 的系统变量的值。
$(if,expr, dotrue [, dofalse]) 如果 expr 为非零，则进行计算并返回 dotrue 。否则，进行计算并返回 dofalse 。
$(index, which, string) 返回以逗号分隔的字符串中的指定成员。which 参数第一项编号为 0；
$(nth, which, arg0 [, arg1,…, arg7]) 计算并返回由 which 选定的参数。如果 which 为 0，则 nth 返回 arg0 ，依此类推。
$(rtos, value [, mode, precision]) 按指定的格式和精度返回实数值。
$(strlen,string) 返回 string 的字符长度。
$(substr, string, start [, length]) 返回 string 的子串，该子串从字符 start 开始，长度为 length 。字符串中的字符从 1 开始编号。如果省略 length ，则返回所有剩余字符串。
$(upper, string) 返回 string 按当前地区的规则转换为大写的结果。
通常，如果 Diesel 表达式中存在错误，AutoCAD会根据错误的性质，DIESEL 在输出流中嵌入一个错误指示。四种错误提示如下：
1、$? ：语法错误（通常是由于括号不匹配或字符串太长）；
2、 $(func,??) ：func 的参数错误；
3、$(func)?? ：未知函数func；
4、$(++) ：输出字符串太长 — 计算被截断；
三、应用
1、在菜单或按钮中使用。要在菜单宏中使用Diesel表达式，需在Diesel表达式前加上“$M=”。该字串后面所有内容都发送到DIESEL解释器，结果用作宏。如AutoCAD的 UCS 图标按钮，是一个开关按钮，通过Diesel表达式实现UCSICON图标的打开与关闭切换，其宏定义为$M=$(if,$(and,$(getvar,ucsicon),1),^C^C_ucsicon _off,^C^C_ucsicon _on)。具体解读如下：
AutoCAD按钮自定义用户界面
⑴ $(getvar,ucsicon) 函数为获得系统变量UCSICON的值，当UCSICON图标打开，返回值为1；当UCSICON图标关闭，返回值为0；
⑵ $(and, $(getvar,ucsicon),1) 将$(getvar,ucsicon)返回值与1求逻辑与，当返回值为1，该逻辑与结果为真；当返回值为0，该逻辑与结果为假；
⑶ $(if,$(and,$(getvar,ucsicon),1),^C^C_ucsicon _off,^C^C_ucsicon _on) 该条件判断函数，当逻辑与为真时，执行 “^C^C_ucsicon _off” 将已打开的UCSICON图标关闭，当逻辑与返回假时，执行 “^C^C_ucsicon _on” 将已关闭的UCSICON图标打开；
⑷ 命令中 ^C 是特殊字符，功能是取消活动的命令或命令选项，相当于按一次 Esc 键。两个^C 是确保终止上一个命令。
2、在字段中使用。字段中如何插入Diesel表达式详见“DWG文件名与文件内的图名、图号关联修改”。
有编程经验的设计人员，对用好Diesel表达式有优势。当然，Diesel语法简单，对于一般设计人员而言，也可以深入研究Diesel函数及其各种用途，让工作省时省力。欢迎一起探讨！
