RFC-0019:使用进化 = uint64;

."/>
RFC-0019:使用 evolution = uint64;
状态已接受
区域
  • FIDL
说明

添加了一种机制,可为原始类型提供更具描述性的名称。移除状态作为语言的内置功能。引入一个 zx 库,用于包含 中的原初类型。

作者
提交日期(年-月-日)2018-07-17
审核日期(年-月-日)2018-08-03

摘要

添加了一种机制,可为原始类型提供更具描述性的名称。 移除状态作为语言的内置功能。引入一个 zx 库,以包含来自 <zircon/types.h> 的基元类型。

与其他 RFC 的关系

此 RFC 已被以下 RFC 取代:

设计初衷

开发者通常希望为原始类型分配更具描述性的名称。例如,status 是对 int32 更具描述性的名称,但 status 内置于语言中,其他类型无法以相同的方式使用。

设计

此提案仅影响 FIDL 源语言。

  1. 扩展 using 关键字,以便能够为基元类型分配描述性名称。具体来说,请将以下生成式添加到 FIDL 语法中:
using-list = ( using | using-declaration )* ;
using-declaration = "using" , IDENTIFIER ,  "=" , primitive-type , ";" ;
  1. 从语言中移除了 status 原型。现在可以使用语言本身来定义 status 原型类型,而不是将其作为内置功能。

  2. 移除 status 保留字词。现在,我们可以在语言中定义名称,因此不再需要预留 status 一词。添加一个 zx 库,其中包含 Zircon 系统接口定义的原始类型的声明。理想情况下,此库将从包含此信息的未来 syscalls.abigen 生成。例如:

library zx;

using status = int32;
using time = uint64;
using duration = uint64;
[...]

请注意,这些声明必须出现在 using 列表中,并且必须直接引用原语类型。这种方法避免了编译器中的复杂性,因为它们的使用可以立即转换为底层基元类型。

此外,请注意,没有任何目标语言的生成代码有建议的更改。这些类型在目标语言中通过底层原初类型表示。

文档和示例

用法示例

    1: AdvanceTime(zx.duration duration) -> (zx.status status);

向后兼容性

此变更与 FIDL 源语言向后不兼容,因为它移除了 status 原基类型。不过,迁移 status 的现有客户端非常简单,因为它们只需改用 zx.status 即可。

性能

建议的更改不会对效果产生任何影响。

安全

建议的更改不会对安全性产生影响。

测试

该功能将在 Zircon 的 fidl-test 套件中进行测试,方法是添加一个使用 zx 库中每种类型的 FIDL 文件。

缺点、替代方案和未知因素

此提案可在 FIDL 前端中轻松实现,并且无需对特定于语言的后端进行任何更改。

另一种方法是不解决该问题,继续直接使用原始类型。

在先技术和参考资料

此功能在编程语言中非常常见。该语法大致借鉴了 C++。