Differences

This shows you the differences between two versions of the page.

--- api:term:zh [2023/10/20 06:44]
hfsr
+++ api:term:zh [2023/10/20 08:33]
hfsr [Term(终端) API]
@@ Line 29: / Line 29: @@
 从终端读取一些文本，即让用户能够输入一些文本。例如，此函数被shell和Lua解释器用来读取用户输入。此函数会使当前行从光标位置算起的剩余部分变为可编辑区域。在此区域中可以输入、删除文字，还可以使用左右方向键和home/end键移动光标。
-  ***自OpenOS 1.6起** 此处指定的参数列表已被视为过时。第一个参数为`option`（选项）参数。其索引值被作为`histroy`（历史）对待，命名键取代了旧的参数。出于兼容性考虑，OpenOS 1.6仍然支持以前的用法，即参数列表。
+  ***自OpenOS 1.6起** 此处指定的参数列表已被视为过时。第一个参数为`option`（选项）参数。其索引值被作为`histroy`（历史）对待，命名键取代了旧的参数。出于兼容性考虑，OpenOS 1.6尊重了以前的用法，即参数列表。
   *新的 `ops` 参数支持新键：`nowrap`。`term.read`的默认行为（`nowrap`为`false`）垂直绑定了光标和输入。先前的行为模式下会水平滚动输入，即现在的 `term.read({nowrap=true})`。
-  The optional `history` table can be used to provide predefined text that can be cycled through via the up and down arrow keys. It must be a sequence (i.e. the keys must be a gap-less integral interval starting at 1). This is used for the command history in shell and Lua interpreter, for example. If text is entered and confirmed with enter, it will be added to the end of this table.
+  可选的 `history` 表用于提供预定义文本，这些文本可以通过上下方向键循环选择。文本表必须为序列（即表中键值必须为从1开始的连续不间断的整数）。此功能的使用例为被shell和Lua解释器的命令历史功能。如果有文本输入并且被按下回车键确定，这条文本就会被加入表的末尾。
-  The `dobreak` parameter, when set to `false` (**`nil` defaults to `true`!**) will not enter a new line after input was completed (e.g. by the user pressing enter).
+  `dobreak` 参数在设定为 `false` （**设定为`nil` 默认是 `true`！**）时输入完成后（如用户按下回车键）不会换行。
-  The `hint` parameter is used for tab completion. It can either be a table with strings or a function that returns a table of strings and takes two parameters, the current text and the position in that text, i.e. the signature of the callback is `function(line:string, pos:number):table`.
+  `hint` 参数用于tab键补全。此参数可以为内容是字符串的表，或者接收两个参数并返回字符串表的函数，函数的参数为当前文本和在此文本中的位置，即回调函数的原型为 `function(line:string, pos:number):table`.。
-  The `pwchar` parameter, when given, causes input to be masked using the first char of the given string. For example, providing `"*"` will make all entered characters appear as stars. The returned value will still be the actual text inserted, of course.
+  `pwchar` 参数若给定，输入内容将会用给定字符串的第一个字符遮盖。例如，给定 `"*"` 将会导致输入的字符显示为星号。但返回值当然还是输入的实际内容。
-  The function will return a string if input was successful, `nil` if the pipe was closed (^d), or `false` if the pipe was interrupted (^c)
+  此函数在输入成功后会返回一个字符串，管道关闭（^d）时会返回`nil`，管道中断（^c）时返回`false`。
+  //注1：// `io.stdin:read()` 使用了此函数。
-  //Note//: `io.stdin:read()` uses this function.
+  //注2：//此函数将会把输入的字符串与\n（换行符号）一并返回。如果你只想要输入的字符串，请使用 `io.read()`。
-  //Note 2//: This will return the entered string with the \n (new line character). If you want only the entered string to be returned, use `io.read()`.
 - `term.write(value: string[, wrap: boolean])`
-  Allows writing optionally wrapped text to the terminal starting at the current cursor position, updating the cursor accordingly. It automatically converts tab characters to spaces using `text.detab`. If `wrap` is true, it will automatically word-wrap the text. It will scroll the displayed buffer if the cursor exceeds the bottom of the display area, but *not* if it exceeds the right of the display area (when `wrap` is false).
+  用于将文本输出到终端上光标的当前位置，可选是否自动换行，输出时同时更新光标位置。此函数会自动将tab字符用 `text.detab` 转换。若 `wrap` 为 `true` ，函数将会对文本自动换行。若光标超出了显示区域底部，则函数会自动滚动显示缓冲区（屏幕内容）。但是在超出显示区域右边界时*不会*滚动（若`wrap`为`false`）。
-  //Note//: This method respects io redirection. That is to say, `term.write` writes to the same stream as io.stdout
+  //注：//此方法遵循io重定义。这也就是说`term.write` 与 io.stdout 写入的是同一个流。
 - `term.bind(gpu)`
-  (new in OpenOS 1.6)
+  (OpenOS 1.6新加入)
-  Binds a `gpu` proxy (not address) to the terminal. This method is called automatically during boot when the gpu and screen become available. Note that if manually rebinding a terminal to a screen with different width and height, the terminal draw area will be truncated and not maximized. This changes the gpu used in all terminal output, not just via the term api, i.e. `io.write`, `print`, `io.stdout:write`, etc all use the same output stream, and term.bind is used to change the `gpu` used.
+  将某个 `gpu` 代理对象（而不是地址）绑定到终端。若gpu与屏幕均可用，此方法在启动时会自动调用。请注意如果手动将终端重新绑定到高度和宽度不同的屏幕，终端绘制区域将会被剪裁，不能最大化显示。此函数改变了所有终端输出使用的gpu，不只是term api使用的，即包含 `io.write`、`print`、`io.stdout:write`以及所有使用同样输出流的函数。term.bind可用于修改上述函数使用的 `gpu`。
 - `term.screen(): string`
-  (new in OpenOS 1.6)
+  (OpenOS 1.6新加入)
-  Convenience method, simply calls `getScreen` on the terminal's bound gpu (see `term.bind`)
+  为了便利而引入的方法，仅仅是在终端绑定的gpu（参见`term.bind`）上调用了 `getScreen`。
 - `term.keyboard(): string`
-  (new in OpenOS 1.6)
+  (OpenOS 1.6新加入)
-  Gets the address of the keyboard the terminal is accepting key events from.
+  获取终端用于接收按键事件的键盘地址。