Go语言上手-常用标准库 | 青训营

137 阅读5分钟

这是我参与「第三届青训营 -后端场」笔记创作活动的的第一篇笔记。主要整理了一些常用库的API,方便后续写代码的时候查阅使用。

Go语言特点

  1. 高性能、高并发
  2. 语法简单
  3. 丰富的标准库
  4. 完善的工具链
  5. 静态链接
  6. 快速编译
  7. 跨平台
  8. 垃圾回收

程序运行命令:

// 直接运行 使用 go run
go run example/01-hello/main.go

// 编译生成二进制文件后运行 使用 go build
go build .\example\01-hello\main.go
.\main.exe

常用库:

fmt:格式化IO

%v	自动匹配类型的默认格式
%+v 输出更多信息
%#v	输出包含变量类型的完整信息
// 普通输出
func Print(a ...any) (n int, err error)
// 格式化输出
func Printf(format string, a ...any) (n int, err error)
// 附加换行符输出
func Println(a ...any) (n int, err error)

// 从标准输入中读取值,以空格/换行符为分隔
func Scan(a ...any) (n int, err error)
// 格式化标准输入
func Scanf(format string, a ...any) (n int, err error)
// 从标准输入中读取,直到遇到换行符
func Scanln(a ...any) (n int, err error)

bufio:带缓冲IO

bufio包实现了有缓冲的I/O。它包装一个io.Reader或io.Writer接口对象,创建另一个也实现了该接口,且同时还提供了缓冲和一些文本I/O的帮助函数的对象。

bufio.Reader接口:

// NewReaderSize 将 rd 封装成一个带缓存的 bufio.Reader 对象,
// 缓存大小由 size 指定(如果小于 16 则会被设置为 16)。
// 如果 rd 的基类型就是有足够缓存的 bufio.Reader 类型,则直接将
// rd 转换为基类型返回。
func NewReaderSize(rd io.Reader, size int) *Reader

// NewReader 相当于 NewReaderSize(rd, 4096)
func NewReader(rd io.Reader) *Reader

// Peek 返回缓存的一个切片,该切片引用缓存中前 n 个字节的数据,
// 该操作不会将数据读出,只是引用,引用的数据在下一次读取操作之
// 前是有效的。如果切片长度小于 n,则返回一个错误信息说明原因。
// 如果 n 大于缓存的总大小,则返回 ErrBufferFull。
func (b *Reader) Peek(n int) ([]byte, error)

// Read 从 b 中读出数据到 p 中,返回读出的字节数和遇到的错误。
// 如果缓存不为空,则只能读出缓存中的数据,不会从底层 io.Reader
// 中提取数据,如果缓存为空,则:
// 1、len(p) >= 缓存大小,则跳过缓存,直接从底层 io.Reader 中读
// 出到 p 中。
// 2、len(p) < 缓存大小,则先将数据从底层 io.Reader 中读取到缓存
// 中,再从缓存读取到 p 中。
func (b *Reader) Read(p []byte) (n int, err error)

// Buffered 返回缓存中未读取的数据的长度。
func (b *Reader) Buffered() int

// ReadBytes 功能同 ReadSlice,只不过返回的是缓存的拷贝。
func (b *Reader) ReadBytes(delim byte) (line []byte, err error)

// ReadString 功能同 ReadBytes,只不过返回的是字符串。
func (b *Reader) ReadString(delim byte) (line string, err error)

...

bufio.Writer接口:

// NewWriterSize 将 wr 封装成一个带缓存的 bufio.Writer 对象,
// 缓存大小由 size 指定(如果小于 4096 则会被设置为 4096)。
// 如果 wr 的基类型就是有足够缓存的 bufio.Writer 类型,则直接将
// wr 转换为基类型返回。
func NewWriterSize(wr io.Writer, size int) *Writer

// NewWriter 相当于 NewWriterSize(wr, 4096)
func NewWriter(wr io.Writer) *Writer

// WriteString 功能同 Write,只不过写入的是字符串
func (b *Writer) WriteString(s string) (int, error)

// WriteRune 向 b 写入 r 的 UTF-8 编码,返回 r 的编码长度。
func (b *Writer) WriteRune(r rune) (size int, err error)

// Flush 将缓存中的数据提交到底层的 io.Writer 中
func (b *Writer) Flush() error

// Available 返回缓存中未使用的空间的长度
func (b *Writer) Available() int

// Buffered 返回缓存中未提交的数据的长度
func (b *Writer) Buffered() int

// Reset 将 b 的底层 Writer 重新指定为 w,同时丢弃缓存中的所有数据,复位
// 所有标记和错误信息。相当于创建了一个新的 bufio.Writer。
func (b *Writer) Reset(w io.Writer)


bufio的源码解释:zhuanlan.zhihu.com/p/73690883

strconv:字符串转换

最常见的数值转换是 Atoi(string to int)和 Itoa(int to string):

i, err := strconv.Atoi("-42") 
s := strconv.Itoa(-42)

ParseBool,ParseFloat,ParseInt 和 ParseUint 将字符串转换为值:

b, err := strconv.ParseBool("true") 
f, err := strconv.ParseFloat("3.1415", 64) 
i, err := strconv.ParseInt("-42", 10, 64) 
u, err := strconv.ParseUint("42", 10, 64)

FormatBool,FormatFloat,FormatInt 和 FormatUint将值转换为字符串:

s := strconv.FormatBool(true) 
s := strconv.FormatFloat(3.1415, 'E', -1, 64) 
s := strconv.FormatInt(-42, 16) 
s := strconv.FormatUint(42, 16)

os: 提供与操作系统相关的接口

常用变量:

os.Stdin
os.Stdout
os.Stderr

常用类型:

  • File
func OpenFile(name string, flag int, perm FileMode) (*File, error)
func (f *File) Read(b []byte) (n int, err error)
func (f *File) Write(b []byte) (n int, err error)
func (f *File) WriteString(s string) (n int, err error)
  • Process 存放由StartProcess创建的进程的信息
func StartProcess(name string, argv []string, attr *ProcAttr) (*Process, error)
func (p *Process) Kill() error
func (p *Process) Release() error
func (p *Process) Signal(sig Signal) error
func (p *Process) Wait() (*ProcessState, error)
  • strings:类似c中的string.h,包含对字符串控制的函数
// 克隆字符串,对仅包留大字符串中的一小部分能有效减少内存
func Clone(s string) string
func Compare(a, b string) int
func Contains(s, substr string) bool
func ContainsAny(s, chars string) bool
func Replace(s, old, new string, n int) string
func ReplaceAll(s, old, new string) string
func Split(s, sep string) []string
func TrimPrefix(s, prefix string) string
func TrimSuffix(s, suffix string) string

常用类型:

  • Builder

Builder 用于使用 Write 方法有效地实现字符串拼接。 它最大限度地减少了内存复制,提高程序性能。

func StrBuilder(n int, str string) string {
    var builder strings.Builder
    for i := 0; i < n; i++ {
        builder.WriterString(str)
    }
    return builder.String()
}

json

type ColorGroup struct {
    ID     int
    Name   string
    Colors []string
}
group := ColorGroup{
    ID:     1,
    Name:   "Reds",
    Colors: []string{"Crimson", "Red", "Ruby", "Maroon"},
}

// 使用Marshal进行序列化
b, err := json.Marshal(group)

// 使用Unmarshal进行反序列化
var colorgrop []ColorGroup
err := json.Unmarshal(b, &colorgrop)

更多库使用说明可查看官方文档:pkg.go.dev/

Go语言学习资料

Go语言圣经