©
Ce document utilise Manuel du site Web PHP chinois Libérer
import "text/tabwriter"
概观
索引
示例
Package tabwriter实现了一个写入过滤器(tabwriter.Writer),它将输入中的选项卡式列转换为正确对齐的文本。
文本/制表程序包被冻结,并且不接受新功能。
package mainimport ("fmt""os""text/tabwriter")func main() {// Observe how the b's and the d's, despite appearing in the// second cell of each line, belong to different columns. w := tabwriter.NewWriter(os.Stdout, 0, 0, 1, '.', tabwriter.AlignRight|tabwriter.Debug) fmt.Fprintln(w, "a\tb\tc") fmt.Fprintln(w, "aa\tbb\tcc") fmt.Fprintln(w, "aaa\t") // trailing tab fmt.Fprintln(w, "aaaa\tdddd\teeee") w.Flush()}
package mainimport ("fmt""os""text/tabwriter")func main() {// Observe that the third line has no trailing tab,// so its final cell is not part of an aligned column.const padding = 3 w := tabwriter.NewWriter(os.Stdout, 0, 0, padding, '-', tabwriter.AlignRight|tabwriter.Debug) fmt.Fprintln(w, "a\tb\taligned\t") fmt.Fprintln(w, "aa\tbb\taligned\t") fmt.Fprintln(w, "aaa\tbbb\tunaligned") // no trailing tab fmt.Fprintln(w, "aaaa\tbbbb\taligned\t") w.Flush()}
常量
键入Writer
func NewWriter(output io.Writer, minwidth, tabwidth, padding int, padchar byte, flags uint) *Writer
func (b *Writer) Flush() error
func (b *Writer) Init(output io.Writer, minwidth, tabwidth, padding int, padchar byte, flags uint) *Writer
func (b *Writer) Write(buf []byte) (n int, err error)
Writer.Init Package (Elastic) Package (TrailingTab)
tabwriter.go
格式化可以用这些标志进行控制。
const ( // Ignore html tags and treat entities (starting with '&' // and ending in ';') as single characters (width = 1). FilterHTML uint = 1 << iota // Strip Escape characters bracketing escaped text segments // instead of passing them through unchanged with the text. StripEscape // Force right-alignment of cell content. // Default is left-alignment. AlignRight // Handle empty columns as if they were not present in // the input in the first place. DiscardEmptyColumns // Always use tabs for indentation columns (i.e., padding of // leading empty cells on the left) independent of padchar. TabIndent // Print a vertical bar ('|') between columns (after formatting). // Discarded columns appear as zero-width columns ("||"). Debug)
要转义文本段,请使用转义字符进行包围。例如,此字符串中的选项卡“忽略此选项卡: \xff\t\xff ”不会终止单元格,并且为了格式化目的而构成宽度为1的单个字符。
值 0xff 被选中是因为它不能以有效的 UTF-8 序列出现。
const Escape = '\xff'
Writer是一个过滤器,用于在其输入中的制表符分隔列中插入填充以将其与输出对齐。
Writer将传入的字节视为由水平 ('\t') 或垂直 ('\v') 制表符以及换行符 ('\n') 或换页符 ('\f') 组成的单元组成的 UTF-8 编码文本。字符; 换行符和换页符都是换行符。
连续行中制表符终止的单元格构成列。 Writer 根据需要插入填充以使列中的所有单元格具有相同的宽度,从而有效地对齐列。它假定所有字符都具有相同的宽度,但必须指定 tabwidth 的制表符除外。列单元格必须是制表符终止的,而不是制表符分隔的:行结尾处的非制表符终止的结尾文本形成单元格,但该单元格不是对齐列的一部分。例如,在本例中(其中|代表水平制表符):
aaaa|bbb|d aa |b |dd a |aa |cccc|eee
b 和 c 在不同的列中(b 列在所有方面都不是连续的)。d 和 e 根本不在列中(没有终止标签,列也不是连续的)。
Writer 假定所有的 Unicode 代码点具有相同的宽度;在某些字体中或者字符串包含组合字符时,这可能不是真的。
如果设置了 DiscardEmptyColumns ,则会放弃完全由垂直(或“软”)选项卡终止的空列。水平(或“硬”)选项卡终止的列不受此标志的影响。
如果 Writer 配置为过滤 HTML ,则会传递 HTML 标记和实体。为了格式化目的,标签和实体的宽度被假定为零(标签)和一个(实体)。
一段文字可以通过用 Escape 字符括起来进行转义。制表人通过不变的方式传递转义文本段。特别是,它不解释段中的任何制表符或换行符。如果设置了 StripEscape 标志,则 Escape 字符将从输出中剥离; 否则它们也会通过。为了格式化,转义字符的宽度始终计算,不包括转义字符。
换页字符就像换行符,但它也会终止当前行中的所有列(有效地调用 Flush )。下一行中以制表符结尾的单元格开始新列。除非在 HTML 标签内或转义文本段内发现,否则换页字符在输出中显示为换行符。
写入器必须在内部缓冲输入,因为一条线的适当间距可能取决于未来线中的单元。完成调用写入后,客户端必须调用 Flush 。
type Writer struct { // contains filtered or unexported fields}
func NewWriter(output io.Writer, minwidth, tabwidth, padding int, padchar byte, flags uint) *Writer
NewWriter 分配并初始化一个新的 Tabwriter.Writer 。参数与 Init 函数相同。
func (b *Writer) Flush() error
在上次调用 Write 之后应该调用 Flush ,以确保写入器中缓冲的任何数据都写入输出。出于格式化目的,任何不完整的转义序列都视为完成。
func (b *Writer) Init(output io.Writer, minwidth, tabwidth, padding int, padchar byte, flags uint) *Writer
写入器必须通过对 Init 的调用进行初始化。第一个参数(输出)指定了过滤器输出。其余参数控制格式:
minwidth minimal cell width including any padding tabwidth width of tab characters (equivalent number of spaces)padding padding added to a cell before computing its width padchar ASCII char used for paddingif padchar == '\t', the Writer will assume that the width of a '\t' in the formatted output is tabwidth, and cells are left-aligned independent of align_left(for correct-looking results, tabwidth must correspond to the tab width in the viewer displaying the result)flags formatting control
package mainimport ("fmt""os""text/tabwriter")func main() { w := new(tabwriter.Writer)// Format in tab-separated columns with a tab stop of 8. w.Init(os.Stdout, 0, 8, 0, '\t', 0) fmt.Fprintln(w, "a\tb\tc\td\t.") fmt.Fprintln(w, "123\t12345\t1234567\t123456789\t.") fmt.Fprintln(w) w.Flush()// Format right-aligned in space-separated columns of minimal width 5// and at least one blank of padding (so wider column entries do not// touch each other). w.Init(os.Stdout, 5, 0, 1, ' ', tabwriter.AlignRight) fmt.Fprintln(w, "a\tb\tc\td\t.") fmt.Fprintln(w, "123\t12345\t1234567\t123456789\t.") fmt.Fprintln(w) w.Flush()}
func (b *Writer) Write(buf []byte) (n int, err error)
写入器写 buf 给写入器 b 。返回的唯一错误是在写入底层输出流时遇到的错误。