[返回博客](/cn/blog) # IFC SDK 和 SDAI：使用简单数据类型属性

Egor Vorobyov 十月 22, 2020 [\#ifc](/cn/blog/tag/ifc) [\#getting started](/cn/blog/tag/getting-started)

<a class="a2a_button_facebook"></a><a class="a2a_button_twitter"></a><a class="a2a_button_linkedin"></a>

IFC SDK 支持标准数据访问接口 (SDAI)，它提供了一个低级 API，用于操作使用 EXPRESS 模式定义的数据。本文介绍了如何使用简单数据类型的属性。

有关在 IFC SDK 中使用 SDAI 的详细信息，请参阅[本文](https://www.opendesign.com/blog/2020/october/working-standard-data-access-interface-oda-ifc-sdk)。

#### 访问简单类型属性

SDAI 中有几种简单类型：sdaiINTEGER、sdaiREAL、sdaiNUMBER、sdaiBOOLEAN、sdaiLOGICAL、sdaiSTRING 和 sdaiINSTANCE。

对于此示例，我们将从应用程序实例 #5 中读取其中一个属性：

```
//#5 = IFCAPPLICATION(#1, '2019', 'Autodesk Revit 2019 (ENU)', 'Revit');
```

首先，我们使用 sdaiGetEntityById 获取一个应用程序实例。然后，我们调用 sdaiGetAttrBN 从实例中获取属性。sdaiGetAttrBN 有四个参数：

- 实例
- 属性名称
- 查询参数的类型
- 指向一个参数的指针，用于将属性值复制到该参数

如果成功，该函数将返回指向第四个参数的指针，否则返回 null：

```
SdaiAppInstance applicationInstance = _sdaiGetEntityById(model, 5);
TEST_ASSERT(applicationInstance != NULL);
TEST_ASSERT(sdaiErrorQuery() == sdaiNO_ERR);
```

接下来我们将尝试三次读取参数。

第一次尝试中，我们成功获取了一个名为“applicationdeveloper”的参数。我们收到了一个句柄为 #1 的应用程序实例。因此，让我们检查收到的数据。使用 \_sdaiGetEntityById 从应用程序实例中获取 ID。它应该等于 1：

```
SdaiAppInstance developer = NULL;
TEST_ASSERT(sdaiGetAttrBN(applicationInstance, 
 				"applicationdeveloper", 
 				sdaiINSTANCE, 
 				&developer) != NULL);
TEST_ASSERT(developer != NULL);
TEST_ASSERT(developer == _sdaiGetEntityById(model, 1));
TEST_ASSERT(sdaiErrorQuery() == sdaiNO_ERR);
```

第二次尝试中，我们从名为“version”的属性中获取一个字符串值。它也应该成功读取属性值。将其与“2019”进行比较，以确保我们读取了有效数据：

```
SdaiString version = NULL;
TEST_ASSERT(sdaiGetAttrBN(applicationInstance, "version", sdaiSTRING, &version) != NULL);
TEST_ASSERT(odStrCmpA(version, "2019") == 0);
TEST_ASSERT(sdaiErrorQuery() == sdaiNO_ERR);
```

第三次尝试中，我们尝试从名为“version”的属性中获取一个整数值。操作失败，因为我们请求了不兼容的类型 sdaiINTEGER。在这种情况下，sdaiGetAttrBN 返回 NULL。调用 sdaiErrorQuery 获取最后一个错误并重置错误状态。错误代码使用 FIFO 规则在错误查询处收集。每次 sdaiErrorQuery 调用都会从错误队列中移除最后一个错误状态：

```
SdaiInteger wrongAttrType = -1;
TEST_ASSERT(sdaiGetAttrBN(applicationInstance, "version", sdaiINTEGER, &wrongAttrType) == NULL);
TEST_ASSERT(sdaiErrorQuery() == sdaiVT_NVLD);
```

另一种简单类型是枚举。SDAI 还支持从应用程序实例中获取枚举值。

例如，假设一个 .ifc 文件在 DATA 部分包含以下条目：

```
// #43= IFCSIUNIT(*,.LENGTHUNIT.,.MILLI.,.METRE.);
```

点之间的字符串值是一个枚举值。现在读取其中一个值。首先，我们使用 \_sdaiGetEntityById 从模型中获取一个实例：

```
SdaiAppInstance applicationInstance = _sdaiGetEntityById(model, 43);
TEST_ASSERT(applicationInstance != NULL);
TEST_ASSERT(sdaiErrorQuery() == sdaiNO_ERR);
```

然后我们要求应用程序实例返回一个类型化属性。该枚举有其自己的 typedef：

```
/* enumeration data type: */
typedef char *SdaiEnum;
```

如我们所见，它的值表示一个字符串值。声明此类型的一个变量，并将指向此值的指针作为第四个参数传递给 sdaiGetAttrBN。如果操作成功，我们将获取此参数并将其与示例文件中的值进行比较：

```
SdaiEnum enumValue = NULL;
TEST_ASSERT(sdaiGetAttrBN(applicationInstance, 
  				"prefix", 
 				sdaiENUM, 
   				&enumValue) != NULL);
TEST_ASSERT(!odStrCmpA(enumValue, "MILLI"));
```

## 今天就开始行动

**免费试用 ODA 软件 60 天。  
无风险，无需信用卡。**

[免费试用](https://www.opendesign.com/cn/free-trial)