pub fun poll_key_decoded() Result[key.Key, str];
类似于 poll_key,但会将方向键的转义序列解码为特殊按键。
在 POSIX 后端上,方向键到达时表现为 3 字节序列 ESC '[' 'A'..'D'; 该函数会消费这些后续字节并返回匹配的特殊按键。单独的 ESC(或任何不属于方向键开头的字节)将按原样返回。 Windows 系统已经在 poll_key 中解码了方向键,因此在那里它是一个直通操作。
注意事项:在慢速连接上,后续字节到达的时间可能会比 ESC 晚一个轮询周期;但在本地终端上表现良好。需要原始模式(raw mode)。
ret:Ok(key) —— 一个特殊的方向键、一个普通的字节,或者如果没有等待的按键则返回 key_none —— 或者在真正的读取失败时返回错误。