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 平台)。