"to asynchronously return" 的术语是什么?
What is the term for "to asynchronously return"?
很多编程语言都有异步函数的概念。异步函数的 return 值不是所需类型本身,而是最终包含该值的 promise/future。
我正在做技术写作,我正在努力为异步 returning 值的行为想出一个简洁的术语。考虑以下同步函数:
function foo(): boolean { ... }
这里写"If foo
returns true
, ..."这个完全可以理解
现在考虑这个异步函数:
function bar(): Promise<boolean> { ... }
我可以写:"If bar
returns a promise that resolves to true
, ..." 这在技术上是正确的,但相当尴尬,尤其是在重复使用时。
我可以这样写:"If bar
asynchronously returns true
, ..." 这个比较短,但我不是很满意。对我来说,它强调 "asynchronously",而不是“true
”。
我可以写:"If bar
returns true
, ..."这很短,但在技术上不正确。
我想写这样的东西:"If bar
yields true
, ...",但是 yield 动词在可迭代对象的上下文中已经有不同的含义(至少在某些语言中).
有没有一种简洁的方式来表达这个概念?
我认为 yield(或者它的同义词 produce)完全没问题。从上下文中可以清楚地看出承诺的意思。当不清楚时,我会使用长的和技术上精确的版本(returns 实现 的承诺)。
另一种选择是 当 bar()
解析为 true
时,省略隐含的 "the promise returned by the call" 但使用 bar()
而不是bar
引用调用的结果,而不是函数本身(这不是可以解决的承诺)。
很多编程语言都有异步函数的概念。异步函数的 return 值不是所需类型本身,而是最终包含该值的 promise/future。
我正在做技术写作,我正在努力为异步 returning 值的行为想出一个简洁的术语。考虑以下同步函数:
function foo(): boolean { ... }
这里写"If foo
returns true
, ..."这个完全可以理解
现在考虑这个异步函数:
function bar(): Promise<boolean> { ... }
我可以写:"If bar
returns a promise that resolves to true
, ..." 这在技术上是正确的,但相当尴尬,尤其是在重复使用时。
我可以这样写:"If bar
asynchronously returns true
, ..." 这个比较短,但我不是很满意。对我来说,它强调 "asynchronously",而不是“true
”。
我可以写:"If bar
returns true
, ..."这很短,但在技术上不正确。
我想写这样的东西:"If bar
yields true
, ...",但是 yield 动词在可迭代对象的上下文中已经有不同的含义(至少在某些语言中).
有没有一种简洁的方式来表达这个概念?
我认为 yield(或者它的同义词 produce)完全没问题。从上下文中可以清楚地看出承诺的意思。当不清楚时,我会使用长的和技术上精确的版本(returns 实现 的承诺)。
另一种选择是 当 bar()
解析为 true
时,省略隐含的 "the promise returned by the call" 但使用 bar()
而不是bar
引用调用的结果,而不是函数本身(这不是可以解决的承诺)。