跳转至

公式及函数

在龙宫STC中，您可在公式字段中中可直接进行输入函数，使用函数计算公式的值。本章节提供目前支持的函数说明。

算术运算符

执行两个变量或值的运算。

运算符 描述 备注
+ 加 可用于函数之间的运算和字符串之间的运算
- 减
* 乘
/ 除
% 余 3%2余1,值就=1

比较运算符

用于逻辑语句的判断，从而确定给定的两个值或变量是否相等。 给定A=2。

运算符 描述 比较 结果 备注
== 等于 A==1
A==2		 false
ture
=== 恒等于（值和类型均相等） A==='2'
A===2		 false
ture
!= 不等于 A!=2
A!=4		 false
ture
!== 不恒等于(值和类型均不等) A!==2
A!=='2'		 false
ture
> 大于 A>3
A>1		 false
ture
< 小于 A<1
A<3		 false
ture
>= 大于等于 A>=3
A>=2		 false
ture
<= 小于等于 A<=1
A<=2		 false
ture

逻辑运算符

用来确定变量或值之间的逻辑关系。给定A=2，B=3。

运算符 描述 示例 结果 备注
&& 和（两个条件均为真） (A==2&&B==2)
(A==2&&B==3)		 false
true
|| 或（前后两个条件其一为真即可） (A==1||B==2)
(A==2||B==2)		 false
true
! 非（两个条件均为假） !(A!=B)
!(A==B)		 false
true

数学函数

用于执行数学任务的函数。

函数 描述 输入参数 公式 结果 示例
random 生成随机数 无 random() 生成[0,1)之间的随机数 公式：random()
值：0.873
round 对参数小数位
进行四舍五后取整		 C1=8.37 round(C1) 8 C1=12.56
公式：round(C1)
值：13
ceil 对参数的小数位
进行上舍入后取整		 C1=8.37 ceil(C1) 9 C1=9.1
公式：ceil(C1)
值：10
floor 对参数的小数位
进行下舍入后取整		 C1=8.37 floor(C1) 8 C1=9.1
公式：ceil(C1)
值：9
trunc 截取参数的
整数部分		 C1=3.141... trunc(C1) 3 C1=12.56...
公式：trunc(C1)
值：12
pow 对浮点数求幂 C1=2
C2=3		 pow(C1,C2) 8 C1=2;C2=3
公式：pow(C1,C2)
值：8
log 生成参数的
自然对数
（底数为e）		 C1=1 log（C1） 0 C1=1
公式：log(C1)
值：0
sqrt 取参数的平方根 C1=4 sqrt(C1) 2 C1=16
公式：sqrt(C1)
值：4
exp 生成以自然数e
为底数的指数		 C1=
log（2）		 exp(C1) 2 C1=2
公式：exp(C1)
值：7.389
abs 取参数的绝对值 C1=-8 abs(C1) 8 C1=-7
公式：abs(C1)
值：7
min 在参数组中取最小值 C1=1
C2=2
C3=3
...		 min(C1,C2,C3,...) 1 C1=1;C2=2;C3=3;
公式：min(C1,C2,C3,)
值：1
max 在参数组中取最大值 C1=99
C2=98
C3=97
...		 max(C1,C2,C3,...) 99 C1=99;C2=98;C3=97;
公式：min(C1,C2,C3,)
值：99
sum 对参数求和 C1=2
C2=3		 sum(C1,C2) 5 C1=3;C2=4
公式：sum(C1,C2)
值：7
sqsum 对参数的平方求和 C1=2
C2=3		 sqsum(C1,C2) 13 C1=3;C2=4
公式：sqsum(C1,C2)
值：25
ave 对参数求平均值 C1=2
C2=3		 ave(C1,C2) 2.5 C1=3;C2=4
公式：ave(C1,C2)
值：3.5
sqave 对参数的平方求平均值 C1=2
C2=3		 sqave(C1,C2) 6.5 C1=3;C2=4
公式：sqave(C1,C2)
值：12.5
hypot 返回斜边的值 C1=3
C2=4		 hypot(C1,C2) 5 C1=5;C2=12
公式：hypot(C1,C2)
值：13

三角函数

用于执行三角函数计算的函数。

函数 描述 输入参数 公式 结果 示例
sin 取参数的正弦值 C1=90 sin(C1) 1 C1=30
公式：sin(C1)
值：0.5
cos 取参数的余弦值 C1=90 cos(C1) 0 C1=60
公式：cos(C1)
值：0.5
tan 取参数的正切值 C1=45 tan(C1) 1 C1=30
公式：tan(C1)
值：0.577
sinh 取参数的双曲正弦值 C1=1 sinh(C1) 1.175 C1=2
公式：sinh(C1)
值：3.627
cosh 取参数的双曲余弦值 C1=1 cosh(C1) 1.543 C1=2
公式：cosh(C1)
值：3.762
tanh 取参数的双曲正切值 C1=0.5 tanh(C1) 0.462 C1=1
公式：tanh(C1)
值：0.762
asin 取参数的反正弦值 C1=0.5 asin(C1) 0.524 C1=0.8
公式：asin(C1)
值：0.927
asinh 取参数的双曲反正弦值 C1=0.5 asinh(C1) 0.481 C1=0.4
公式：asinh(C1)
值：0.39
acos 取参数的反余弦值 C1=0.5 acos(C1) 1.047 C1=0.99
公式：sin(C1)
值：0.142
acosh 取参数的双曲反余弦值 C1=1 acosh(C1) 0 C1=2
公式：acosh(C1)
值：1.317
atan 取参数的反正切值 C1=30 atan(C1) 1.537 C1=60
公式：stan(C1)
值：1.554
atan2 取参数比值的反正切值 C1=30
C2=1		 atan2(C1,C2) 1.537 C1=30;C2=0.5
公式：atan2(C1,C2)
值：1.554

请注意

系统会自动帮您区分弧度制和角度值，您可以直接在函数的括号内输入角度或数值。

参考函数

用于引用参考对象的值。

par函数

说明

  • 用于获取引用对象所支持的属性值。

函数用法

  • par(rid,属性名)

输入参数

  1. rid：模型中对象的rid值，可在编辑器中获取，类型为 BigInt。
  2. 属性名： 指定该函数获取对象中属性种类，参数类型为字符串，详情请参考下文中的属性参考表。

返回值

  • 函数获取rid所对应的对象，根据传入的属性名获取对应的属性值。返回值类型与属性值类型相同。支持的属性及返回类型可参考下表。
  • 对象属性参考表：
属性名 用法 返回值
angle par(rid,"angle") 获取对应 rid 中零件的旋转角度
返回值 angle，类型为 double
area par(rid,"area") 获取对应 rid 中零件的面积
返回值 area, 类型为double
assembleType par(rid,"assembleType") 获取对应 rid 中的工厂/工地类型
返回值 0 或 1，类型为 number
 0 为工厂类型，1 为工地类型
assNoPrefix par(rid,"assNoPrefix") 获取对应 rid 中零件的构件编号前缀
返回值 assNoPrefix，类型为 srting
assNoStart par(rid,"assNoStart") 获取对应 rid 中零件的构件起始编号
返回值 assNoStart，类型为 number
assNoStartPostfix par(rid,"assNoStartPostfix") 获取对应 rid 中零件的构件起始编号
返回值 assNoStartPostfix，类型为 string
boltSize par(rid,"boltSize") 获取对应 rid 中的螺栓尺寸
返回值 boltSize，类型为 number
boltStandard par(rid,"boltStandard") 获取对应 rid 中的螺栓标准
返回值 boltStandard，类型为 string
circleCount par(rid,"corc;eCpimt") 获取对应 rid 中螺栓的环形数量
返回值 circleCount，类型为 number
circleD par(rid,"circleD") 获取对应 rid 中螺栓的环形直径
返回值 circleD，类型为 number
class par(rid,"class") 获取对应 rid 中零件的颜色等级
返回值 class，类型为 number
curvePlane par(rid,"curvePlane") 获取对应 rid 中零件的曲梁平面类型
返回值 1 或 2，类型为 number
1 为竖向，2 为横向
curveR par(rid,"curveR") 获取对应 rid 中零件的曲梁半径
返回值 curveR，类型为 number
curveSegs par(rid,"curveSegs") 获取对应 rid 中零件的曲梁分段数
返回值 curveSegs，类型为 number
cutLen par(rid,"cutLen") 获取对应 rid 中螺栓的切割长度
返回值 cutLen，类型为 number
cutTpye par(rid,"cutType") 获取对应 rid 中控制点的切角类型
返回值 0~7，类型为 number
cutX par(rid,"cutX") 获取对应 rid 中控制点的切角X方向距离
返回值 cutX，类型为 number
cutY par(rid,"cutY") 获取对应 rid 中控制点的切角Y方向距离
返回值 cutY，类型为 number
dx0 par(rid,"dx0") 获取对应 rid 中零件的起始Dx距离
返回值 dx0，类型为 number
dx1 par(rid,"dx1") 获取对应 rid 中零件的末尾Dx距离
返回值 dx1，类型为 number
dy0 par(rid,"dy0") 获取对应 rid 中零件的起始Dy距离
返回值 dy0，类型为 number
dy1 par(rid,"dy1") 获取对应 rid 中零件的末尾Dy距离
返回值 dy1，类型为 number
dz0 par(rid,"dz0") 获取对应 rid 中零件的起始Dz距离
返回值 dz0，类型为 number
dz1 par(rid,"dz1") 获取对应 rid 中零件的末尾Dz距离
返回值 dz1，类型为 number
enable par(rid,"enable") 对应 rid 中的零件是否启用
返回值 true 或 false，类型为 bool
endPt par(rid,"endPt") 获取对应 rid 中零件的控制点结束点坐标
返回值 endPt，类型为 vector
extLen par(rid,"extLen") 获取对应 rid 中螺栓的附加长度
返回值 extLen，类型为 number
finish par(rid,"finish") 获取对应 rid 中零件的抛光
返回值 finish，类型为 string
hole_x par(rid,"hole_x") 获取对应 rid 中螺栓的X方向长孔
返回值 hole_x，类型为 number
hole_y par(rid,"hole_y") 获取对应 rid 中螺栓的Y方向长孔
返回值 hole_y，类型为 number
holeTol par(rid,"holeTol") 获取对应 rid 中螺栓的容许误差
返回值 holeTol，类型为 number
length par(rid,"length") 获取对应 rid 中零件的长度
返回值 length, 类型为double
listX par(rid,"listX") 获取对应 rid 中螺栓的自定义坐标X
返回值 listX，类型为 array
listY par(rid,"listY") 获取对应 rid 中螺栓的自定义坐标Y
返回值 listY，类型为 array
mtrl par(rid,"mtrl") 获取对应 rid 中零件的材质
返回值 mtrl，类型为 string  
name par(rid,"name") 获取对应 rid 中零件的名称
返回值 name，类型为 string
no par(rid,"no") 获取对应 rid 中零件的零件编号
返回值 no，类型为 string
noPrefix par(rid,"noPrefix") 获取对应 rid 中零件的零件编号前缀
返回值 noPrefix，类型为 string
noStart par(rid,"noStart") 获取对应 rid 中零件的零件起始编号
返回值 noStart，类型为 number
noStartPostfix par(rid,"noStartPostfix") 获取对应 rid 中零件的零件起始编号
返回值 noStartPostfix，类型为 string
offsetH par(rid,"offsetH") 获取对应 rid 中零件的竖向偏移距离
返回值 offsetH，类型为 number
offsetHSide par(rid,"offsetHSide") 获取对应 rid 中零件的竖向位置
返回值 0 或 8 或 1，类型为 number
0 为前，8 为中，1 为后
offsetV par(rid,"offsetV") 获取对应 rid 中零件的横向偏移距离
返回值 offsetV，类型为 number
offsetVSide par(rid,"offsetVSide") 获取对应 rid 中零件的横向位置
返回值 0 或 8 或 1，类型为 number
5 为左，8 为中，4 为右
overSizeHole0 par(rid,"overSizeHole0") 获取对应 rid 中螺栓的长孔1是否启用
返回值 true 或 false，类型为 bool
overSizeHole1 par(rid,"overSizeHole1") 获取对应 rid 中螺栓的长孔2是否启用
返回值 true 或 false，类型为 bool
overSizeHole2 par(rid,"overSizeHole2") 获取对应 rid 中螺栓的长孔3是否启用
返回值 true 或 false，类型为 bool
overSizeHole3 par(rid,"overSizeHole3") 获取对应 rid 中螺栓的长孔4是否启用
返回值 true 或 false，类型为 bool
overSizeHole4 par(rid,"overSizeHole4") 获取对应 rid 中螺栓的长孔5是否启用
返回值 true 或 false，类型为 bool
profile par(rid,"profile") 获取对应 rid 中零件的截面型材
返回值 profile，类型为 string
radialAngle par(rid,"radialAngle") 获取对应 rid 中螺栓的放射形角度
返回值 radialAngle，类型为 number
radialCount par(rid,"radialCount") 获取对应 rid 中螺栓的放射形数量
返回值 radialCount，类型为 number
radialD par(rid,"radialD") 获取对应 rid 中螺栓的放射形直径
返回值 radialD，类型为 number
radialStride par(rid,"radialStride") 获取对应 rid 中螺栓的放射形间距
返回值 radialStride，类型为 array
rotSide par(rid,"rotSide") 获取对应 rid 中零件的位置朝向所对应的值
返回值 rotSide，类型为 number
2为顶，3为底，4为前，5为后
sameNoCount par(rid,"sameNoCount") 获取对应 rid 中零件的相同编号的计数
返回值 sameNoCount，类型为 number
sectNut0 par(rid,"sectNut0") 获取对应 rid 中螺栓的螺母1是否启用
返回值 true 或 false，类型为 bool
sectNut1 par(rid,"sectNut1") 获取对应 rid 中螺栓的螺母2是否启用
返回值 true 或 false，类型为 bool
sectWasherDown0 par(rid,"sectWasherDown0") 获取对应 rid 中螺栓的下垫片1是否启用
返回值 true 或 false，类型为 bool
sectWasherDown1 par(rid,"sectWasherDown1") 获取对应 rid 中螺栓的下垫片2是否启用
返回值 true 或 false，类型为 bool
sectWasherUp par(rid,"sectWasherUp") 获取对应 rid 中螺栓的上垫片是否启用
返回值 true 或 false，类型为 bool
shape par(rid,"shape") 获取对应 rid 中螺栓的排列形状类型
返回值 1~9，类型为 number
sizeDown par(rid,"sizeDown") 获取对应 rid 中焊缝的线下尺寸
返回值 sizeDown，类型为 number
sizeUp par(rid,"sizeUp") 获取对应 rid 中焊缝的线上尺寸
返回值 sizeUp，类型为 number
startPt par(rid,"startPt") 获取对应 rid 中零件的控制点起始点坐标
返回值 startPt，类型为 vector
strideX par(rid,"strideX") 获取对应 rid 中螺栓的阵列间距X
返回值 strideX，类型为 array
strideY par(rid,"strideY") 获取对应 rid 中螺栓的阵列间距Y
返回值 strideX，类型为 array
studLen par(rid,"studLen") 获取对应 rid 中的剪力钉长度
返回值 studLen，类型为 number
threadInMtrl par(rid,"threadInMtrl") 获取对应 rid 中的螺栓有无剪切面螺纹
返回值 true 或 false，类型为 bool
typeDown par(rid,"typeDown") 获取对应 rid 中焊缝的线下类型
返回值 0~26，类型为 number
typeUp par(rid,"typeUp") 获取对应 rid 中焊缝的线上类型
返回值 0~26，类型为 number
volume par(rid,"volume") 获取对应 rid 中零件的体积
返回值 volume, 类型为double
weight par(rid,"weight") 获取对应 rid 中零件的重量
返回值 weight, 类型为double

Tips

  • 使用par(rid,"startPt").x可以获取对应 rid 中零件的控制点起始点的 X 绝对坐标。
  • 使用par(rid,"startPt").y可以获取对应 rid 中零件的控制点起始点的 Y 绝对坐标。
  • 使用par(rid,"startPt").z可以获取对应 rid 中零件的控制点起始点的 Z 绝对坐标。
  • 使用par(rid,"endPt").x可以获取对应 rid 中零件的控制点结束点的 X 绝对坐标。
  • 使用par(rid,"endPt").y可以获取对应 rid 中零件的控制点起始点的 Y 绝对坐标。
  • 使用par(rid,"endPt").z可以获取对应 rid 中零件的控制点起始点的 Z 绝对坐标。
  • 用户属性参考表：
属性名 用法 返回值
lock par(rid,"lock") 获取对应 rid 中物体用户属性的锁定状态
返回值 true 或 false ，类型为 bool
mark par(rid,"mark") 获取对应 rid 中物体用户属性的评注内容
返回值 mark ，类型为 string
shortMark par(rid,"shortMark") 获取对应 rid 中物体用户属性的短评内容
返回值 shortMark ，类型为 string
cut par(rid,"cut") 获取对应 rid 中物体用户属性的剪短量
返回值 cut ，类型为 number
arch par(rid,"arch") 获取对应 rid 中物体用户属性的起拱内容
返回值 arch ，类型为 string
midLineExtension par(rid,"midLineExtension") 获取对应 rid 中物体用户属性的中线延伸量
返回值 midLineExtension ，类型为 number
prepareMark par(rid,"prepareMark") 获取对应 rid 中物体用户属性的预备标记内容
返回值 prepareMark ，类型为 string
prepareAssMark par(rid,"prepareAssMark") 获取对应 rid 中物体用户属性的预备构件标记内容
返回值 prepareAssMark ，类型为 string
maker par(rid,"maker") 获取对应 rid 中物体用户属性的制造者内容
返回值 maker ，类型为 string
userArea1 par(rid,"userArea1") 获取对应 rid 中物体用户属性的用户区域1
返回值 userArea1 ，类型为 string
userArea2 par(rid,"userArea2") 获取对应 rid 中物体用户属性的用户区域2
返回值 userArea2 ，类型为 string
userArea3 par(rid,"userArea3") 获取对应 rid 中物体用户属性的用户区域3
返回值 userArea3 ，类型为 string
userArea4 par(rid,"userArea4") 获取对应 rid 中物体用户属性的用户区域4
返回值 userArea4 ，类型为 string
userState par(rid,"userState") 获取对应 rid 中物体用户属性的用户状态内容
返回值 userState ，类型为 string
drawMainView par(rid,"drawMainView") 获取对应 rid 中物体用户属性的图纸主视图方向
返回值 drawMainView ，类型为 number
2为顶，3为底，4为前，5为后
productNnm par(rid,"productNnm") 获取对应 rid 中物体用户属性的产品号
返回值 productNnm ，类型为 string
productDescribe par(rid,"productDescribe") 获取对应 rid 中物体用户属性的产品描述
返回值 productDescribe ，类型为 string
productWeight par(rid,"productWeight") 获取对应 rid 中物体用户属性的产品重量
返回值 productWeight ，类型为 number
producer par(rid,"producer") 获取对应 rid 中物体用户属性的生产商内容
返回值 producer ，类型为 string
checker par(rid,"checker") 获取对应 rid 中物体用户属性的检查者内容
返回值 checker ，类型为 string
designMark par(rid,"designMark") 获取对应 rid 中物体用户属性的设计评注内容
返回值 designMark ，类型为 string
designAllot par(rid,"designAllot") 获取对应 rid 中物体用户属性的设计分配内容
返回值 designAllot ，类型为 string
designStandard par(rid,"designStandard") 获取对应 rid 中物体用户属性的设计规范内容
返回值 designStandard ，类型为 string
designStatus par(rid,"designStatus") 获取对应 rid 中物体用户属性的设计状态
返回值 0 或 1 ，类型为 number
checkDay par(rid,"checkDay") 获取对应 rid 中物体用户属性的检查日期
返回值 checkDay ，类型为 string

Tips

  • 需要填写日期时请插入文本输入框控件进行填写。
  • 可读取到的日期格式为“19700101”、“1970.01.01”。

prf函数

说明

  • 用于获取引用对象所支持的截面属性值。

函数用法

  • prf(rid,属性名)
  • prf(profileName,属性名)

输入参数

  1. rid：模型中对象的rid值，可在编辑器中获取，类型为 BigInt。
  2. profileName：模型中对象零件截面的截面名，可通过零件属性窗口中的“截面型材”显示框中获取, 类型为 string。
  3. 属性名： 指定该函数获取对象中属性种类，参数类型为字符串，详情请参考下文中的属性参考表。

返回值

  • 函数获取rid、profileName所对应的对象，根据传入的属性名获取对应的属性值。返回值类型与属性值类型相同。支持的属性及返回类型可参考下表。
  • 属性参考表：
属性名 用法 返回值
name prf(rid,"name")
prf("profileName","name")		 获取对应 rid、profileName 中零件截面的名称
返回值 name，类型为 string
shapeFlangeSlopeRatio1 prf(rid,"shapeFlangeSlopeRatio1")
prf("profileName","shapeFlangeSlopeRatio1")		 获取对应 rid、profileName 中零件截面的斜率 1
返回值 shapeFlangeSlopeRatio1，类型为 number
shapeFlangeSlopeRatio2 prf(rid,"shapeFlangeSlopeRatio2")
prf("profileName","shapeFlangeSlopeRatio2")		 获取对应 rid、profileName 中零件截面的斜率 2
返回值 shapeFlangeSlopeRatio2，类型为 number
shapeFlangeThickness1 prf(rid,"shapeFlangeThickness1")
prf("profileName","shapeFlangeThickness1")		 获取对应 rid、profileName 中零件截面的翼缘(板)厚度 1
返回值 shapeFlangeThickness1，类型为 number
shapeFlangeThickness2 prf(rid,"shapeFlangeThickness2")
prf("profileName","shapeFlangeThickness2")		 获取对应 rid、profileName 中零件截面的翼缘(板)厚度 2
返回值 shapeFlangeThickness2，类型为 number
shapeFlangeWidth1 prf(rid,"shapeFlangeWidth1")
prf("profileName","shapeFlangeWidth1")		 获取对应 rid、profileName 中零件截面的翼缘宽度 1
返回值 shapeFlangeWidth1，类型为 number
shapeFlangeWidth2 prf(rid,"shapeFlangeWidth2")
prf("profileName","shapeFlangeWidth2")		 获取对应 rid、profileName 中零件截面的翼缘宽度 2
返回值 shapeFlangeWidth2，类型为 number
shapeHeight prf(rid,"shapeHeight")
prf("profileName","shapeHeight")		 获取对应 rid、profileName 中零件截面的高度
返回值 shapeHeight，类型为 number
shapeHeight1 prf(rid,"shapeHeight1")
prf("profileName","shapeHeight1")		 获取对应 rid、profileName 中零件截面的高度1
返回值 shapeHeight1，类型为 number
shapeHeight2 prf(rid,"shapeHeight2")
prf("profileName","shapeHeight2")		 获取对应 rid、profileName 中零件截面的高度2
返回值 shapeHeight2，类型为 number
shapeRoundingRadius1 prf(rid,"shapeRoundingRadius1")
prf("profileName","shapeRoundingRadius1")		 获取对应 rid、profileName 中零件截面的半径 1
返回值 shapeRoundingRadius1，类型为 number
shapeRoundingRadius2 prf(rid,"shapeRoundingRadius2")
prf("profileName","shapeRoundingRadius2")		 获取对应 rid、profileName 中零件截面的半径 2
返回值 shapeRoundingRadius2，类型为 number
shapeWebThickness prf(rid,"shapeWebThickness")
prf("profileName","shapeWebThickness")		 获取对应 rid、profileName 中零件截面的腹板厚度
返回值 shapeWebThickness，类型为 number
shapeWidth prf(rid,"shapeWidth")
prf(profileName","shapeWidth")		 获取对应 rid、profileName 中零件截面的宽度
返回值 shapeWidth，类型为 number
subType prf(rid,"subType")
prf("profileName","subType")		 获取对应 rid、profileName 中零件截面的子类型
返回值 subType，类型为 string
type prf(rid,"type")
prf("profileName","type")		 获取对应 rid、profileName 中零件截面的主类型
返回值 type，类型为 string

提示

  • 在引用属性值时您可以通过两种不同输入方式来引用需要的值，以 prf(rid,属性名) 为例。
    简易输入方式：
  • prf(rid,"h")-->获取对应rid零件的截面高度。
  • prf(rid,"b")-->获取对应rid零件的截面宽度。
  • prf(rid,"b1")-->获取对应rid零件的截面宽度1。
  • prf(rid,"b2")-->获取对应rid零件的截面宽度2。
  • prf(rid,"t1")-->获取对应rid零件的截面翼缘（板）厚度1。
  • prf(rid,"t2")-->获取对应rid零件的截面翼缘（板）厚度2。
  • prf(rid,"s")-->获取对应rid零件的截面腹板厚度。
  • prf(rid,"wh1")-->获取对应rid零件的截面腹板宽度1。
  • prf(rid,"wh2")-->获取对应rid零件的截面腹板宽度2。
  • prf(rid,"r1")-->获取对应rid零件截面的圆半径1。
  • prf(rid,"r2")-->获取对应rid零件截面的圆半径2。
  • prf(rid,"fs1")-->获取对应rid零件截面的斜率1。
  • prf(rid,"fs2")-->获取对应rid零件截面的斜率2。
    标准输入方式：
  • prf(rid,"shapeHeight")-->获取对应rid零件的截面高度。
  • prf(rid,"shapeWidth")-->获取对应rid零件的截面宽度。
  • prf(rid,"shapeFlangeWidth1")-->获取对应rid零件的截面翼缘宽度1。
  • prf(rid,"shapeFlangeWidth2")-->获取对应rid零件的截面翼缘宽度2。
  • prf(rid,"shapeFlangeThickness1")-->获取对应rid零件的截面翼缘（板）厚度1。
  • prf(rid,"shapeFlangeThickness2")-->获取对应rid零件的截面翼缘（板）厚度2。
  • prf(rid,"shapeWebThickness")-->获取对应rid零件的腹板厚度。
  • prf(rid,"shapeWebHeight1")-->获取对应rid零件的腹板宽度1。
  • prf(rid,"shapeWebHeight2")-->获取对应rid零件的腹板宽度2。
  • prf(rid,"shapeRoundingRadius1")-->获取对应rid零件的半径1。
  • prf(rid,"shapeRoundingRadius2")-->获取对应rid零件的半径2。
  • prf(rid,"shapeFlangeSlopeRatio1")-->获取对应rid零件的斜率1。
  • prf(rid,"shapeFlangeSlopeRatio2")-->获取对应rid零件的斜率2。

ui函数

说明

  • 用于索引UI编辑器中对应控件的返回值。

函数用法

  • ui('控件索引路径',默认值)

输入参数

  1. 控件索引路径：UI编辑器中控件所在的路径，可在编辑器中获取，类型为 string。
  2. 默认值： 如果控件中没有设置默认值，可在此添加默认值，参数类型为 number 和 string。

返回值

  • 函数获取控件所对应的返回值，根据用户输入的内容获取对应的返回值。返回值类型与控件中输入的内容类型相同。支持的属性及返回类型可参考函数示例表。
  • 函数示例表：
函数名 用法 返回值
ui ui('set',method_set) 返回指定控件名所对应的内容，类型为控件所对应的类型

示例

  • ui('$main.input1', 10): 返回 $main 页面中控件名称为 input1 的值，默认值为 10。如果控件类型为文本输入相关类型，则返回值的类型为 string; 如果为数值输入相关类型，则返回值为 number。
  • ui('weld.weld1.0.sizeUp', 6): 返回 weld 页面中控件名称为 weld1 中的第一行的线上尺寸的值，默认值为 6，类型为 number。

fread函数

说明

  • 从指定的文件名（相对模型）中读取数据。

函数用法

  • fread('文件名','行首字段',列数)
  • fread('文件名',行数,列数)

输入参数

  1. 文件名：以模型根目录路径作为初始路径的含有文件后缀的文件名，类型为 string。
  2. 行首字段： 文件中某一行的第一个字段，参数类型为 string。
  3. 行数: 数据所在的行数，从0开始计数。
  4. 列数: 数据所在的列数，从0开始计数。

返回值

  • 返回指定文件中的指定数据。支持的属性及返回类型可参考函数示例表。
  • 函数示例表：
函数 描述 输入参数 公式 结果 示例
fread
（输入字段格式）		 从指定文件读取数据 文件名（相对模型）；
行首字段；
列数（从0开始）		 fread('文件名','行首字段',列数) 对应行列的字符串 输入：
列表位置
列表

fread('text','FH100*20',1)
值=12
fread
（输入行列格式）		 从指定文件读取数据 文件名（相对模型）；
行数（从0开始）；
列数（从0开始）		 fread('文件名',行数,列数) 对应行列的字符串 输入：
列表位置
列表

fread('text',4,1)
值=12

注意

  • 如果文件不在模型根目录，则以斜线划分目录级别。例如：文件 "text" 在 config 的根目录下，则文件名应填写为'config/text'。

调试函数

函数 描述 输入参数 公式 结果
print 将输入参数对象的值打印到组件运行结果界面 rid print（rid） 在组件运行结果界面可看到打印的rid值
dump 将输入参数对象的详细信息打印到组件运行结果界面 rid print（rid） 在组件运行结果界面可看到打印的rid的详细信息

数据类型转换函数

可以转换数据显示和类型的函数，给定C1=100.12345

函数 描述 示例 结果
toFixed 把数字转换为结果的小数点后有指定位数的数字 C1.toFixed(2) 100.12
toPrecision 把数字的值转换为指数计数法,结果的小数点后有指定位数 C1.toPrecision(3) 1.00e+2

倾斜角度函数

用于求零件间的倾斜角度。

函数 描述 输入参数 公式 结果 示例
skew 生成水平倾斜角度 rid0;rid1
skew		 skew(rid0,rid1) rid0和rid1之间的水平倾斜角度 蓝色：rid100
绿色：rid200
倾斜45°
skew(100,200)
值=45
slope 生成竖直倾斜角度 rid0;rid1
slope		 slope(rid0,rid1) rid0和rid1之间的竖直倾斜角度 蓝色：rid100
绿色：rid200
倾斜45°
slope(100,200)
值=45
cant 生成旋转角度 rid0;rid1
cant		 cant(rid0,rid1) rid0和rid1之间的旋转角度 蓝色：rid100
绿色：rid200
旋转45°
cant(100,200)
值=45

字符串运算

用于处理文本（字符串）的运算方法。

运算 描述 输入参数 公式 结果
length 返回字符串的个数 C1=PL10*30 C1.length 7
indexOf 返回某个指定的字符串值在字符串中首次出现的位置
(从0开始)		 C1=PL10*30 C1.indexOf('L') 1
charAt 返回在指定位置的字符
(从0开始)		 C1=PL10*30 C1.charAt(1) L
substring 返回在指定区间的字符串
(从0开始)		 C1=PL10*30 C1.substring(0,4) PL10

提示

  • 双引号“”和单引号‘’代表空字符串。
  • 在进行字符串与字符串拼接、数值与数值拼接、字符串与数值拼接等操作时，在最前方添加空字符串可得到正确拼接结果。例如，当C1=10;C2=20;C3=30时，在公式中输入：'' + C1 + C2 + C3，可得到值为102030。

控制结构语句

用于计算后输出最后的值。

语句 描述 参数 公式 结果 示例
if 判断输出 A,B,C,D if(A==B) C;else D; C或D A=1
if(A==1) 0; else 1;
值=0
for 循环输出 i for(i=A;i<B;i++) i; B-1 for(i=1;i<10;i++) i;
值=9

值的类型

用于区分不同类型的值。值和类型不符会导致值显示错误。

类型 描述 备注
文本 该变量的公式结果是文本类型 可以调用字符串运算中的函数
值要用双引号"value"或单引号'value'括起来
数值 该变量的公式结果是数值类型 可以使用算术运算符进行计算
整数 以整数格式显示公式的内容 可对公式进行运算，在值内显示结果，只取整数部分
数值队列 以数字队列格式显示公式内容 可显示数列
公式：10 20 30
值：10 20 30
整数队列 以整数队列格式显示公式内容 可显示数列，只取整数部分