R txtProgressBar 文本进度条

说明

文本进度条R安慰。

用法

txtProgressBar(min = 0, max = 1, initial = 0, char = "=",
               width = NA, title, label, style = 1, file = "")

getTxtProgressBar(pb)
setTxtProgressBar(pb, value, title = NULL, label = NULL)
## S3 method for class 'txtProgressBar'
close(con, ...)

参数

min , max	进度条极值的(有限)数值。必须有 min < max 。
initial , value	进度条的初始值或新值。请参阅“详细信息”了解无效值会发生什么情况。
char	组成进度条的字符(或字符串)。必须具有非零显示宽度。
width	进度条的宽度，作为 char 宽度的倍数。如果是 NA (默认值)，则字符数适合 getOption("width") 。
style	酒吧的‘style’ - 请参阅“详细信息”。
file	打开的连接对象或指示控制台的 ""：stderr() 可能在这里有用。
pb , con	类 "txtProgressBar" 的对象。
title , label	忽略，以与其他进度条兼容。
...	为了与通用一致。

细节

txtProgressBar将显示一个进度条R通过文本表示的控制台(或连接)。

setTxtProgessBar 将更新该值。 value 的缺失 ( NA ) 和超出范围的值将被(静默)忽略。 (initial 的此类值会导致在设置有效值之前不会显示进度条。)

完成后进度条应为 close d：这会输出最终的换行符。

style = 1和style = 2只显示一行char。他们的不同之处在于style = 2每次都会重新绘制线条，如果其他代码可能正在写入，这很有用R安慰。style = 3用‘标记范围的结束⁠|⁠’并在栏右侧给出百分比。

值

对于 txtProgressBar 类 "txtProgressBar" 的对象。

对于 getTxtProgressBar 和 setTxtProgressBar ，给出前一个值的长度为 1 的数值向量(对于 setTxtProgressBar 不可见)。

注意

使用style2 或 3 或减少该值style = 1使用‘⁠\r⁠’ 返回左边距 - 回车符的解释取决于其中的终端或控制台R正在运行，这可能会在终端以外的连接上产生丑陋的输出，包括当stdout()被重定向到一个文件。

例子

 # slow
testit <- function(x = sort(runif(20)), ...)
{
    pb <- txtProgressBar(...)
    for(i in c(0, x, 1)) {Sys.sleep(0.5); setTxtProgressBar(pb, i)}
    Sys.sleep(1)
    close(pb)
}
testit()
testit(runif(10))
testit(style = 3)
testit(char=' \u27a4')

也可以看看

winProgressBar(仅限 Windows)、tkProgressBar(类 Unix 平台)。