UG表达式函数总汇

函数名,类型,类别,内置函数说明,例子,返回值,名称

empty?,Boolean,List,判断给定的列表是否为空,"empty?({1,2,3})",FALSE,

equal,Boolean,List,判断给定的两是否相等，可以是列表，安符串及其它类型,"equal({5,6},{3,4})",FALSE,

findDuplicates,list,List,查找给定列表中重复的元素，并以列表形式输出。,"findDuplicates({1,1,3})",{1},

first,Any,List,返回给定数据中的，第一个数据！数据类型任意。,"first({8,2,3})",8,

firstN,List,List,返回指定宽度的列表，右边例子3表示从左向右，三个位置宽度。,"firstN({""a"",""b"",""c"",""d"",""e"",""f""},3)","{""a"",""b"",""c""}",

flatten,List,List,将一个列表中的子列表提升一个等级合并到总列表中。,"flatten(1,2,3{4,5,6})","{1,2,3,4,5,6}",

last,Any,List,返回给定数据中的，最后一个位置的数据！数据类型任意。,"last({1,2,3,""tkl""})","""tkl""",

length,Integer,List,返回给定列表，或者字符串的长度，如果有子列表只算一个。,"length({1,2,{3,4}})Length(""abcd"")",34,

makeLargeList,List,List,返回一个给定数值的非负整数列表。<给定的数字。,makeLargeList(5),"{4,3,2,1,0}",

maxList,Number,List,返回一个数字列表的最大对象,"maxLiat({20,20.5,30,5})",30,

member,Boolean,List,判断给定的参数是否在当前的列表中，返回结果为布尔型。,"member(5,{1,2,3})",FALSE,

minList,Number,List,返回指定列表的最小对象,"minList({20,20.5,30,5})",5,

nth,Any,List,返回指定列表的第X项，如果X>总长度返回最后一个，如果<=0返回第1个,"nth(3,{""a"",""b"",""c"",""d"",""e""})","""c""",

rest,Any,List,返回指定列表中除了第一项的所有对象,"rest(1,2,3,{4,5})","{2,3,{4,5}}",

reverse,list,List,反向排序,"reverse({1,2,3,4,5})","{5,4,3,2,1}",

second,Any,List,返回给定列表中的第二个对象。,"second({""a"",""b"",""c"",""d""})","""b""",

subList,list,List,返回指定宽度的列表数据。,"subList({""a"",""b"",""c"",""d"",""e""},2,4)","{""b"",""c"",""d""}",

third,Any,List,返回给定列表中的第三个对象。,"third({""a"",""b"",""c"",""d""})","""c""",

ug_findClosestNumberInList,Integer,List,将指定的数与列表中相近匹配，然后返回它左边的数。（返回为整数型）,"ug_findClosestNumberInList(5,{""1"",""2"",""7"",""4"",""9"",""8""})",3,

ug_findNumberInList,Integer,List,将指定的数与列表中匹配，如果不匹配返回0，匹配返回左边数过去第N-1个位置数。,"ug_findNumberInList（2,{""5"",""2"",""3""})",1,Position

ASCII,Integer,String,返回给定字符串中第一个字符的ASCII码，如果该字符串为空，则返回零,"ASCII(""ABC"")",65,

Char,String,String,返回给定整数的ASCII字符，范围为1至255,Char(97),"""a""",

charReplace,String,String,用指定字符串替换指定位置的原字符串,"charReplace(""要涨工资"",""要"",""被"")","""被涨工资""",

compareString,Integer,String,比较两个字符串，区分大小写srt1>str2返回1，等于返回0，反之返回-1,"compareString(""Aa"",""A"")",1,

format,String,String,使用C样式的格式化规格，返回格式化的字符串,"format(""打着幌子%s"",""为人民服务"")","""打着幌子为人民服务""",

MakeNumber,Any,String,返回给定数字字符串的数字或整数(将数字字符串转成整形或浮点型),"MakeNumber(""12.4"")",12.4,

replaceString,String,String,将str1的所有事例替换为str2,"replaceString(""所谓法律"",""所谓"",""扯蛋"")","""扯蛋法律""",

StringLower,String,String,返回给定字符串的小写字符串,"StringLower(""中文ABC"")","""中文abc""",

StringUpper,String,String,返回给定字符串的大写字符串,"StringUpper(""中文abc"")","""中文ABC""",

subString,String,String,返回一个新字符串，使其包含原始列表中元素的子集,"subString(""水货太多"",3,6)","""货太""",

ug_pointToString,String,String,读取屏幕上的一个点，并返回成字符串,"ug_poingtToString(Point(0,0,0))","""Point(0,0,0)""",

ug_vectorToString,String,String,读取一个矢量，然后返回成字符串。,"ug_vectorToString(Vector(0.0,0.0,1.0))","""Vector(0,0,1""",

abs,Number,Math,返回给定数字的绝对值,abs(-45),45,

acosine,Number,Math,以度数为单位返回给定数字的反余弦,acosine(0.5),60,

asine,Number,Math,以度数为单位返回给定数字的反正弦,asine(0.5),30,

atangent,Number,Math,返回给定数字的反正切，以度数为单位，范围是-90到+90,atangent(1),45,

atangent2,Number,Math,返回给定增量y除以指定增量x的反正切，以度数为单位，范围是-180到+180,"atangent2(-10,10)",135,

ceiling,Any,Math,返回大于给定数字的最小整数(向上取整),ceiling(8.001[cm]),81,

cos,Number,Math,以度数为单位返回给定数字的余弦,cos(60),0.5,

floor,Any,Math,返回小于或等于给定数字的最小整数(向下取整),floor(8.001[cm]),80,

hypsin,Number,Math,返回给定数字的双曲正弦,hypsin(0),0,

hyptan,Number,Math,返回给定数字的双曲正切,hyptan(0),0,

log,Number,Math,返回给数字的自然对数,log(exp(1)),1,

log10,Number,Math,返回给定数字的以10为底的对数,log10(100),2,

max,Number,Math,从给定数字和其他数字中返回最大数,"max(1,3,4,5)",5,

minimun,Number,Math,从给定数字和其他数字中返回最小数,"minimum(1,2,4,5)",1,

mod,Number,Math,返回给定分子除以指定分母时(按整数除法)的余数(模数)符号以分子为准,"mod(11.5,2)",1.5,

nx_x,Number,Math,"返回给定点或者矢量的X值如果P点坐标为(1,2,3)",nx_x(P),1,

nx_y,Number,Math,"返回给定点或者矢量的Y值如果P点坐标为(1,2,3)",nx_y(P),2,

nx_z,Number,Math,"返回给定点或者矢量的Z值如果P点坐标为(1,2,3)",nx_z(P),3,

pi,Number,Math,返回pi(圆周率),pi(),3.141592654,

round,Any,Math,返回给定数字最接近的整数，如果给定的数字以0.5结尾，四舍五入！,round(5.6789[cm]),57,

sin,Number,Math,以度数为单位返回给定数字的正弦,sin(30),0.5,

sqrt,Number,Math,返回给定正数的平方根数,sqrt(4),2,

tan,Number,Math,返回给定数字的正切,tan(45),1,

ug_equal,Boolean,Math,判断两个数是否在给定的公差范围内相等,"ug_equal(4.223,4.223,""tol"",1.0e-6)",TRUE,

ug_cell_hlookup,Any,spreadsheet,用法类似电子表格中的HLOOKUP的函数,详见左边备注中,返回数据类型为任意,

ug_cell_read,Any,spreadsheet,读取指定电子表格数据，读取数据类型为任意。,"格式为：ug_cell_read(""表格位置"",""读取单元格"")",返回数据类型为任意,

ug_cell_vlookup,Any,spreadsheet,用法类似电子表格中的VLOOKUP的函数,与ug_cell_hlookup用法类似,返回数据类型为任意,

ug_excel_read,Number,spreadsheet,读取指定电子表格数据，读取数据类型仅为浮点型,"格式为：ug_excel_read(""表格位置"",""读取单元格"")",返回数据仅为浮点型,

ug_list_hloolup,List,spreadsheet,用法类似ug_cell_hlookup会提取整列数据出来。,,返回一个列表,

ug_cell_read,Any,spreadsheet,读取指定电子表格数据，读取数据类型为任意。,"格式为：ug_cell_read(""表格位置"",""读取单元格"")",返回数据类型为任意,

ug_cell_vlookup,Any,spreadsheet,用法类似电子表格中的VLOOKUP的函数,与ug_cell_hloolup用法类似,返回数据类型为任意,

ug_excel_read,Number,spreadsheet,读取指定电子表格数据，读取数据类型仅为浮点型。,"格式为：ug_excel_read(""表格位置"",""读取单元格"")",返回数据仅为浮点型,

ug_list_hloolup,list,spreadsheet,用法类似ug_cell_hlookup会提取整列数据出来。,,返回一个列表,

ug_list_vlookup,list,spreadsheet,用法类似ug_cell_vloolup会提取整行数据出来。,,返回一个列表,

ug_read_fixed_list,list,spreadsheet,水平或者竖直读取电子表格中的数据(用指定范围)。,"格式为：ug_read_fixed_list(""表格位置"",""B1:B8"")",返回一个列表,

ug_read_list,list,spreadsheet,水平或者竖直读取电子表格中的数据，直到为单元格为止。,"格式为：ug_read_list(""表格位置"",""A1"",true)",返回一个列表,

ug_find_file,String,Pts_func,此函数是用来查找指定文件的位置,,,

angle2Vectors,Number,Geometry,用于测定给两矢量之间的角度，返回值与视觉矢量方向有关。,"angle2Vectors(Vector(1,0,0),Vector(0,1,0),Vector(0,0,-1))",270,

arcCenter2Point,Point,Geometry,通过给两点与一个法向方向平判断圆弧的圆心。,"arcCenrer2Point(Point(5,0,0),Point(0,5,0),5,Vector()0,0,1),true)","点(0,0,0)",

arcCenter3Point,Point,Geometry,给定三个点，返回通这个三点圆弧的圆心坐标。,"arcCenrer3Point(Point(-1,0,0),Point(0,1,0),Point(1,0,0))","Point(0,0,0),Point(2.5,5,2.5,0),Point(7.5,7.5,0))",

chainPointLists,list,Geometry,返回给定公差范围内的点集列表,"chainPointLists({{Point(0,0,0),Point(2.5,2.5,0),Point(5,0,0),Point(7.5,7.5,0),Point(10,0,0)}},10)","{Point(0,0,0),Point(2.5,2.5,0),Point(5,0,0),Point(7.5,7.5,0)}",

dist,Number,Geometry,返回给定两个点之间的距离,"dist(Point(0,0,0),Point(3,4,0))",5,

interLineLine,Point,Geometry,个人理解此函数是用来求两条直线的交点,"interLineLine(Point(4,3,0),Vector(1,0,0),Point(5,6,0),Vector(sqrt(2)/2,sqrt(2)/2,0))","Point(2,3,0)",

NormalizeAngle,Number,Geometry,将给定的角度(以度数为单位)规范化为0至360度之间的值,NormalizeAngle(420),60,

onRight？,Boolean,Geometry,我个人理解为判定一个点是否在给定矢量方向的右边,"onRight?(Point(0,0,0),Point(3,4,0),Vector(0,1,0),Vector(0,0,1))",FALSE,

perpendicular,Vector,Geometry,给定一矢量，返回给定矢量的垂直矢量，方向为笛卡尔坐标系原则。,"perpendicular(Vector(1,0,0))","矢量(0,1,0)",

polygonDifference,list,Geometry,与下方函数用法一样，区别在于除了求相交部份，还会把第一步点集也输出来。,"polygonDifference({Point(0,0,0),Point(3,0,0),Point(0,3,0)},{Point(1,1,0),point(3,1,0),point(3,3,0)})","{{Point(2,1,0),Point(1.5,1.5,0),Point(1,1,0),Point(0,0,0),Point(3,0,0),Point(0,3,0)}}",

polygonIntersection,list,Geometry,给定两个点集，系统会根据点连结成多边形，最后求两个图形的公共点集。,"polygonIntersection({Point(0,0,0),point(3,0,0),point(0,3,0)},{Point(1,1,0),point(3,1,0),point(3,3,0)})","{{Point(2,1,0),point(1.5,1.5,0),point(1,1,0)}}",

projectPoint,Point,Geometry,应该是将一个点投影到指定的平面内，返回投影后点坐标。,"projectPoint(Point(4,5,12),Point(10,20,0)Vector(0,0,1))","点(4,5,0)",

projectVector,Vector,Geometry,应该是将一矢量投影到指定的平面内，返回投影后矢量。,"projectVector(Vector(1,2,3),Point(0,0,0),Vector(0,0,1))","矢量(1,2,0)",

Radians,Number,Geometry,将以度数为单位的角度转换为弧度,Radians(180),3.141592654,

rotateVector,Vector,Geometry,旋转矢量,"rotateVector(Vector(1,0,0),60,Vector(0,0,1))","矢量(0.5,0.86660254038,0)",

unitize,Vector,Geometry,标准化一个矢量，最大值为1,"unitize(Vector(3,4,0))","矢量(0.6,0.8,0)",

dateTimeString,String,Misc,返回个人电脑系统日期与时间：“FriNov2109:56:122005/,"dateTimeString(""localTime?"",false)","""riJun0723:53:462011""",

getenv,String,Misc,返回给定环境变量的值,"getenv(""UGII_LANG"")","""simpl_chinese""",

stringValue,String,Misc,将给定的文体转化为字符串类型,stringValue(56),"""56""",

ug_askExpressionValueAsString,String,Expression,将表达式的值以一定的格式作为字