第3 章 编程基础 3
1 UG/Open API 函数 3
1 函数名称的约定 UG/Open API 共有两类名称约定
一个是标准的UG/Open API的函数名称约定;另一个是以前版本原有的名称约定
1、标准名称约定 格式:UF__ 说明: UF_,user funciton的简写,表示该函数为 UG/Open API函数; ,应用或模块的名称缩写
例如 modl和 disp分别是Modeling模块和 Display功能的名称缩写; ,表示其实现功能的语言描述,一般由下划线分开的动词和名词(或词组)组成
常用的动词有:ask(查询)、create(创建)、edit(编辑)、set(设置)、delete(删除)等
例如: UF_MODL_create_block1()为创建立方体的函数; UF_DISP_set_highlight()是高亮显示对象的函数; (2)非标准名称约定 格式:uc 和 uf 说明:代表 UG/Open API C程序,通常是四位数或三位数接一个字母
例如:uc1601是一个提示信息函数
2 函数参数的约定 UG/Open API提供的函数遵守 ANSI/ISO C的标准,并以下列格式在头文件中提供函数原型: (变量列表); 返回数据类型通常是C数据类型或UG/Open API自定义数据类型
参数的输入输出方式有3种:I(Input)、O(Output)或OF(Output Free),说明见表 3-1
表 3-1 参数输入方式说明 元 素 描 述 I 表示参数为输入方式,参数在使用前必须赋值 O 表示参数为输出方式,使用前无须赋值 OF 表示参数为输出方式,且使用后需要释放内存
UG/Open API提供的常用 释 放 内 存 函 数有UF_free()、 UF_free_string()和UF_ST