©
本文档使用
php.cn手册 发布
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()}示例（TrailingTab）
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是一个过滤器，用于在其输入中的制表符分隔列中插入填充以将其与输出对齐。
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
func NewWriter(output io.Writer, minwidth, tabwidth, padding int, padchar byte, flags uint) *Writer
NewWriter 分配并初始化一个新的 Tabwriter.Writer 。参数与 Init 函数相同。
func (*Writer) Flush
func (b *Writer) Flush() error
在上次调用 Write 之后应该调用 Flush ，以确保写入器中缓冲的任何数据都写入输出。出于格式化目的，任何不完整的转义序列都视为完成。
func (*Writer) Init
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 (*Writer) Write
func (b *Writer) Write(buf []byte) (n int, err error)
写入器写 buf 给写入器 b 。返回的唯一错误是在写入底层输出流时遇到的错误。