转换 | strconv

• import "strconv"

• 概观

• 索引

• 示例

概观

包strconv实现了对基本数据类型的字符串表示的转换。

Numeric Conversions

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

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

这些假设小数和 Go int 类型。

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)

解析函数返回最宽的类型（float64，int64和uint64），但如果 size 参数指定较窄的宽度，则结果可以转换为较窄的类型而不会丢失数据：

s := "2147483647" // biggest int32
i64, err := strconv.ParseInt(s, 10, 32)
...
i := int32(i64)

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)

AppendBool，AppendFloat，AppendInt 和 AppendUint 是相似的，但将格式化后的值附加到目标切片。

字符串转换

Quote 和 QuoteToASCII 将字符串转换为带引号的字符串文字。后者保证结果是一个 ASCII 字符串，用 \ u 转义任何非 ASCII 的 Unicode：

q := Quote("Hello, 世界")
q := QuoteToASCII("Hello, 世界")

QuoteRune 和 QuoteRuneToASCII 类似，但接受符文并返回引用的去符文字面值。

Unquote 和 UnquoteChar 不引用 Go 字符串和符文字面值。

索引

• 常量

• 变量

• func AppendBool(dst []byte, b bool) []byte

• func AppendFloat(dst []byte, f float64, fmt byte, prec, bitSize int) []byte

• func AppendInt(dst []byte, i int64, base int) []byte

• func AppendQuote(dst []byte, s string) []byte

• func AppendQuoteRune(dst []byte, r rune) []byte

• func AppendQuoteRuneToASCII(dst []byte, r rune) []byte

• func AppendQuoteRuneToGraphic(dst []byte, r rune) []byte

• func AppendQuoteToASCII(dst []byte, s string) []byte

• func AppendQuoteToGraphic(dst []byte, s string) []byte

• func AppendUint(dst []byte, i uint64, base int) []byte

• func Atoi(s string) (int, error)

• func CanBackquote(s string) bool

• func FormatBool(b bool) string

• func FormatFloat(f float64, fmt byte, prec, bitSize int) string

• func FormatInt(i int64, base int) string

• func FormatUint(i uint64, base int) string

• func IsGraphic(r rune) bool

• func IsPrint(r rune) bool

• func Itoa(i int) string

• func ParseBool(str string) (bool, error)

• func ParseFloat(s string, bitSize int) (float64, error)

• func ParseInt(s string, base int, bitSize int) (i int64, err error)

• func ParseUint(s string, base int, bitSize int) (uint64, error)

• func Quote(s string) string

• func QuoteRune(r rune) string

• func QuoteRuneToASCII(r rune) string

• func QuoteRuneToGraphic(r rune) string

• func QuoteToASCII(s string) string

• func QuoteToGraphic(s string) string

• func Unquote(s string) (string, error)

• func UnquoteChar(s string, quote byte) (value rune, multibyte bool, tail string, err error)

• type NumError

• func (e *NumError) Error() string

示例

AppendBool

AppendFloat

AppendInt

AppendQuote

AppendQuoteRune

AppendQuoteRuneToASCII

AppendQuoteToASCII

AppendUint

Atoi

CanBackquote

FormatBool

FormatFloat

FormatInt

FormatUint

IsPrint

Itoa

NumError

ParseBool

ParseFloat

ParseInt

ParseUint

Quote

QuoteRune

QuoteRuneToASCII

QuoteToASCII

Unquote UnquoteChar

打包文件

atob.go atof.go atoi.go decimal.go doc.go extfloat.go ftoa.go isprint.go itoa.go quote.go

常量

IntSize 是 int 或 uint 值的大小（以位为单位）。

const IntSize = intSize

变量

ErrRange 表示目标类型的值超出范围。

var ErrRange = errors.New("value out of range")

ErrSyntax 表明一个值没有针对目标类型的正确语法。

var ErrSyntax = errors.New("invalid syntax")

func AppendBoolSource

func AppendBool(dst []byte, b bool) []byte

AppendBool 根据 b 的值将“true”或“false”附加到 dst 并返回扩展缓冲区。

示例

package main

import (
	"fmt"
	"strconv"
)

func main() {
	b := []byte("bool:")
	b = strconv.AppendBool(b, true)
	fmt.Println(string(b))

}

func AppendFloatSource

func AppendFloat(dst []byte, f float64, fmt byte, prec, bitSize int) []byte

AppendFloat 将由 FormatFloat 生成的浮点数 f 的字符串形式附加到 dst 并返回扩展缓冲区。

示例

package main

import (
	"fmt"
	"strconv"
)

func main() {
	b32 := []byte("float32:")
	b32 = strconv.AppendFloat(b32, 3.1415926535, 'E', -1, 32)
	fmt.Println(string(b32))

	b64 := []byte("float64:")
	b64 = strconv.AppendFloat(b64, 3.1415926535, 'E', -1, 64)
	fmt.Println(string(b64))

}

func AppendIntSource

func AppendInt(dst []byte, i int64, base int) []byte

AppendInt 将由 FormatInt 生成的整数i的字符串形式附加到 dst 并返回扩展缓冲区。

示例

package main

import (
	"fmt"
	"strconv"
)

func main() {
	b10 := []byte("int (base 10):")
	b10 = strconv.AppendInt(b10, -42, 10)
	fmt.Println(string(b10))

	b16 := []byte("int (base 16):")
	b16 = strconv.AppendInt(b16, -42, 16)
	fmt.Println(string(b16))

}

func AppendQuoteSource

func AppendQuote(dst []byte, s string) []byte

AppendQuote 将由 Quote 生成的代表 s 的双引号 Go 字符串文字附加到 dst 并返回扩展缓冲区。

示例

package main

import (
	"fmt"
	"strconv"
)

func main() {
	b := []byte("quote:")
	b = strconv.AppendQuote(b, `"Fran & Freddie's Diner"`)
	fmt.Println(string(b))

}

func AppendQuoteRuneSource

func AppendQuoteRune(dst []byte, r rune) []byte

AppendQuoteRune 将由 QuoteRune 生成的表示符文的单引号 Go 字符文字附加到 dst 并返回扩展缓冲区。

示例

package main

import (
	"fmt"
	"strconv"
)

func main() {
	b := []byte("rune:")
	b = strconv.AppendQuoteRune(b, '☺')
	fmt.Println(string(b))

}

func AppendQuoteRuneToASCIISource

func AppendQuoteRuneToASCII(dst []byte, r rune) []byte

AppendQuoteRuneToASCII 将由 QuoteRuneToASCII 生成的代表该符文的单引号 Go 字符文字附加到 dst 并返回扩展缓冲区。

示例

package main

import (
	"fmt"
	"strconv"
)

func main() {
	b := []byte("rune (ascii):")
	b = strconv.AppendQuoteRuneToASCII(b, '☺')
	fmt.Println(string(b))

}

func AppendQuoteRuneToGraphicSource

func AppendQuoteRuneToGraphic(dst []byte, r rune) []byte

AppendQuoteRuneToGraphic 将由 QuoteRuneToGraphic 生成的表示符文的单引号 Go 字符文字附加到 dst 并返回扩展缓冲区。

func AppendQuoteToASCIISource

func AppendQuoteToASCII(dst []byte, s string) []byte

AppendQuoteToASCII 将由 QuoteToASCII 生成的代表 s 的双引号 Go 字符串文字附加到 dst 并返回扩展缓冲区。

示例

package main

import (
	"fmt"
	"strconv"
)

func main() {
	b := []byte("quote (ascii):")
	b = strconv.AppendQuoteToASCII(b, `"Fran & Freddie's Diner"`)
	fmt.Println(string(b))

}

func AppendQuoteToGraphicSource

func AppendQuoteToGraphic(dst []byte, s string) []byte

AppendQuoteToGraphic 将由 QuoteToGraphic 生成的代表 s 的双引号 Go 字符串文字附加到 dst 并返回扩展缓冲区。

func AppendUintSource

func AppendUint(dst []byte, i uint64, base int) []byte

AppendUint 将由 FormatUint 生成的无符号整数 i 的字符串形式附加到 dst 并返回扩展缓冲区。

示例

package main

import (
	"fmt"
	"strconv"
)

func main() {
	b10 := []byte("uint (base 10):")
	b10 = strconv.AppendUint(b10, 42, 10)
	fmt.Println(string(b10))

	b16 := []byte("uint (base 16):")
	b16 = strconv.AppendUint(b16, 42, 16)
	fmt.Println(string(b16))

}

func AtoiSource

func Atoi(s string) (int, error)

Atoi 返回 ParseInt(s, 10, 0) 转换为 int 类型的结果。

示例

package main

import (
	"fmt"
	"strconv"
)

func main() {
	v := "10"
	if s, err := strconv.Atoi(v); err == nil {
		fmt.Printf("%T, %v", s, s)
	}

}

func CanBackquoteSource

func CanBackquote(s string) bool

CanBackquote 报告字符串 s 是否可以不改变为单行反引号字符串，而不包含 tab 以外的控制字符。

示例

package main

import (
	"fmt"
	"strconv"
)

func main() {
	fmt.Println(strconv.CanBackquote("Fran & Freddie's Diner ☺"))
	fmt.Println(strconv.CanBackquote("`can't backquote this`"))

}

func FormatBoolSource

func FormatBool(b bool) string

FormatBool 根据 b 的值返回“true”或“false”

示例

package main

import (
	"fmt"
	"strconv"
)

func main() {
	v := true
	s := strconv.FormatBool(v)
	fmt.Printf("%T, %v\n", s, s)

}

func FormatFloatSource

func FormatFloat(f float64, fmt byte, prec, bitSize int) string

FormatFloat 根据格式 fmt 和 precision prec 将浮点数f转换为字符串。它将结果进行四舍五入，假设原始数据是从 bitSize 位的浮点值获得的（float32为32，float64为64）。

格式 fmt 是 'b'（-ddddp±ddd，二进制指数），'e'（-d.dddde±dd，十进制指数），'E'（-d.ddddE±dd，十进制指数），'f'（-ddd.dddd，无指数），'g'（'e'表示大指数，'f'表示否则）或 'G'（'E'表示大指数，否则'f'）。

precision prec 控制由 'e'，'E'，'f'，'g' 和 'G' 格式打印的位数（不包括指数）。对于 'e'，'E' 和 'f'，它是小数点后的位数。对于 'g' 和 'G' 这是总位数。特殊精度-1使用必需的最小位数，以便 ParseFloat 完全返回 f 。

示例

package main

import (
	"fmt"
	"strconv"
)

func main() {
	v := 3.1415926535

	s32 := strconv.FormatFloat(v, 'E', -1, 32)
	fmt.Printf("%T, %v\n", s32, s32)

	s64 := strconv.FormatFloat(v, 'E', -1, 64)
	fmt.Printf("%T, %v\n", s64, s64)

}

func FormatIntSource

func FormatInt(i int64, base int) string

FormatInt 返回给定基数中的i的字符串表示，对于2 <= base <= 36.结果对于数字值> = 10使用小写字母 'a' 到 'z' 。

示例

package main

import (
	"fmt"
	"strconv"
)

func main() {
	v := int64(-42)

	s10 := strconv.FormatInt(v, 10)
	fmt.Printf("%T, %v\n", s10, s10)

	s16 := strconv.FormatInt(v, 16)
	fmt.Printf("%T, %v\n", s16, s16)

}

func FormatUintSource

func FormatUint(i uint64, base int) string

FormatUint 返回给定基数中的 i 的字符串表示，对于2 <= base <= 36.结果对于数字值> = 10使用小写字母 'a' 到 'z' 。

示例

package main

import (
	"fmt"
	"strconv"
)

func main() {
	v := uint64(42)

	s10 := strconv.FormatUint(v, 10)
	fmt.Printf("%T, %v\n", s10, s10)

	s16 := strconv.FormatUint(v, 16)
	fmt.Printf("%T, %v\n", s16, s16)

}

func IsGraphicSource

func IsGraphic(r rune) bool

IsGraphic 报告符文是否被 Unicode 定义为 Graphic。这些字符包括类别 L，M，N，P，S 和 Z 中的字母，标记，数字，标点，符号和空格。

func IsPrintSource

func IsPrint(r rune) bool

IsPrint 报告该符文是否被 Go 定义为可打印，其定义与 unicode.IsPrint 相同：字母，数字，标点，符号和 ASCII 空格。

示例

package main

import (
	"fmt"
	"strconv"
)

func main() {
	c := strconv.IsPrint('\u263a')
	fmt.Println(c)

	bel := strconv.IsPrint('\007')
	fmt.Println(bel)

}

func ItoaSource

func Itoa(i int) string

Itoa 是 FormatInt(int64(i), 10) 的缩写。

示例

package main

import (
	"fmt"
	"strconv"
)

func main() {
	i := 10
	s := strconv.Itoa(i)
	fmt.Printf("%T, %v\n", s, s)

}

func ParseBoolSource

func ParseBool(str string) (bool, error)

ParseBool 返回字符串表示的布尔值。它接受1，t，T，TRUE，true，True，0，f，F，FALSE，false，False。任何其他值都会返回错误。

示例

package main

import (
	"fmt"
	"strconv"
)

func main() {
	v := "true"
	if s, err := strconv.ParseBool(v); err == nil {
		fmt.Printf("%T, %v\n", s, s)
	}

}

func ParseFloatSource

func ParseFloat(s string, bitSize int) (float64, error)

ParseFloat 将字符串 s 转换为浮点数，精度由 bitSize：32指定，float32为64; float64为64。当 bitSize = 32时，结果仍然具有 float64 类型，但可以在不更改其值的情况下将其转换为 float32。

如果s格式良好且接近有效的浮点数，则 ParseFloat 返回使用 IEEE754 无偏舍入舍入的最近浮点数。

ParseFloat 返回的错误具有具体类型 * NumError 并包含 err.Num = s。

如果 s 在语法上不是格式良好的，ParseFloat 返回 err.Err = ErrSyntax。

如果 s 在语法上格式良好，但距离给定大小的最大浮点数大于1/2 ULP，则 ParseFloat 返回 f =±Inf，err.Err = ErrRange。

示例

package main

import (
	"fmt"
	"strconv"
)

func main() {
	v := "3.1415926535"
	if s, err := strconv.ParseFloat(v, 32); err == nil {
		fmt.Printf("%T, %v\n", s, s)
	}
	if s, err := strconv.ParseFloat(v, 64); err == nil {
		fmt.Printf("%T, %v\n", s, s)
	}

}

func ParseIntSource

func ParseInt(s string, base int, bitSize int) (i int64, err error)

ParseInt 解释给定基础（2到36）中的字符串 s 并返回相应的值 i。如果 base == 0，则基数由字符串的前缀隐含：base 16代表“0x”，base 8代表“0”，否则以10为底数。

bitSize 参数指定结果必须适合的整数类型。位大小 0,8,16,32 和 64 对应于 int，int8，int16，int32 和 int64。

ParseInt 返回的错误具有具体类型 * NumError 并包含err.Num = s。如果s为空或包含无效数字，则 err.Err = ErrSyntax，返回值为0; 如果与s对应的值不能用给定大小的有符号整数表示，则 err.Err = ErrRange，返回的值是相应 bitSize 和符号的最大幅度整数。

示例

package main

import (
	"fmt"
	"strconv"
)

func main() {
	v32 := "-354634382"
	if s, err := strconv.ParseInt(v32, 10, 32); err == nil {
		fmt.Printf("%T, %v\n", s, s)
	}
	if s, err := strconv.ParseInt(v32, 16, 32); err == nil {
		fmt.Printf("%T, %v\n", s, s)
	}

	v64 := "-3546343826724305832"
	if s, err := strconv.ParseInt(v64, 10, 64); err == nil {
		fmt.Printf("%T, %v\n", s, s)
	}
	if s, err := strconv.ParseInt(v64, 16, 64); err == nil {
		fmt.Printf("%T, %v\n", s, s)
	}

}

func ParseUintSource

func ParseUint(s string, base int, bitSize int) (uint64, error)

ParseUint 就像 ParseInt，但是对于无符号数字。

示例

package main

import (
	"fmt"
	"strconv"
)

func main() {
	v := "42"
	if s, err := strconv.ParseUint(v, 10, 32); err == nil {
		fmt.Printf("%T, %v\n", s, s)
	}
	if s, err := strconv.ParseUint(v, 10, 64); err == nil {
		fmt.Printf("%T, %v\n", s, s)
	}

}

func QuoteSource

func Quote(s string) string

Quote 返回一个双引号的 Go 字符串字面表示s。返回的字符串使用 Go 转义序列 (\t, \n, \xFF, \u0100) 作为 IsPrint 定义的控制字符和非可打印字符。

示例

package main

import (
	"fmt"
	"strconv"
)

func main() {
	s := strconv.Quote(`"Fran & Freddie's Diner	☺"`)
	fmt.Println(s)

}

func QuoteRuneSource

func QuoteRune(r rune) string

QuoteRune 返回一个表示符文的单引号 Go 字符。返回的字符串使用 Go 转义序列(\t, \n, \xFF, \u0100) 作为 IsPrint 定义的控制字符和非可打印字符。

示例

package main

import (
	"fmt"
	"strconv"
)

func main() {
	s := strconv.QuoteRune('☺')
	fmt.Println(s)

}

func QuoteRuneToASCIISource

func QuoteRuneToASCII(r rune) string

QuoteRuneToASCII 返回表示符文的单引号 Go 字符。对于非 ASCII 字符和 IsPrint 定义的非可打印字符，返回的字符串使用 Go 转义序列 (\t, \n, \xFF, \u0100)。

示例

package main

import (
	"fmt"
	"strconv"
)

func main() {
	s := strconv.QuoteRuneToASCII('☺')
	fmt.Println(s)

}

func QuoteRuneToGraphicSource

func QuoteRuneToGraphic(r rune) string

QuoteRuneToGraphic 返回代表符文的单引号 Go 字符。对于非 ASCII 字符和 IsGraphic 定义的非可打印字符，返回的字符串使用Go转义序列 (\t, \n, \xFF, \u0100)。

func QuoteToASCIISource

func QuoteToASCII(s string) string

QuoteToASCII 返回一个代表 s 的双引号 Go 字符串。对于非 ASCII 字符和 IsPrint 定义的非可打印字符，返回的字符串使用 Go 转义序列 (\t, \n, \xFF, \u0100) 。

示例

package main

import (
	"fmt"
	"strconv"
)

func main() {
	s := strconv.QuoteToASCII(`"Fran & Freddie's Diner	☺"`)
	fmt.Println(s)

}

func QuoteToGraphicSource

func QuoteToGraphic(s string) string

QuoteToGraphic 返回一个代表 s 的双引号 Go 字符串。对于非 ASCII 字符和 IsGraphic 定义的非可打印字符，返回的字符串使用 Go 转义序列 (\t, \n, \xFF, \u0100)。

func UnquoteSource

func Unquote(s string) (string, error)

Unquote 将 s 解释为单引号，双引号或反引号的 Go 字符串文字，返回引用的字符串值。（如果 s 是单引号，它将是一个 Go 字符字面量； Unquote 会返回相应的一个字符字符串。）

示例

package main

import (
	"fmt"
	"strconv"
)

func main() {
	test := func(s string) {
		t, err := strconv.Unquote(s)
		if err != nil {
			fmt.Printf("Unquote(%#v): %v\n", s, err)
		} else {
			fmt.Printf("Unquote(%#v) = %v\n", s, t)
		}
	}

	s := `\"Fran & Freddie's Diner\t\u263a\"\"`
	// If the string doesn't have quotes, it can't be unquoted.
	test(s) // invalid syntax
	test("`" + s + "`")
	test(`"` + s + `"`)
	test(`'\u263a'`)

}

func UnquoteCharSource

func UnquoteChar(s string, quote byte) (value rune, multibyte bool, tail string, err error)

UnquoteChar 解码转义字符串中的第一个字符或字节或由字符串 s 表示的字符字面值。它返回四个值：

1) value, the decoded Unicode code point or byte value;
2) multibyte, a boolean indicating whether the decoded character requires a multibyte UTF-8 representation;
3) tail, the remainder of the string after the character; and
4) an error that will be nil if the character is syntactically valid.

第二个参数 quote 指定了被解析的文字类型，因此允许使用哪个转义引号字符。如果设置为单引号，则允许序列 \'并且不允许未转义'。如果设置为双引号，则允许 \“并禁止未转义”。如果设置为零，它不允许任何转义，并允许两个引号字符显示为未转义。

示例

package main

import (
	"fmt"
	"log"
	"strconv"
)

func main() {
	v, mb, t, err := strconv.UnquoteChar(`\"Fran & Freddie's Diner\"`, '"')
	if err != nil {
		log.Fatal(err)
	}

	fmt.Println("value:", string(v))
	fmt.Println("multibyte:", mb)
	fmt.Println("tail:", t)

}

type NumErrorSource

NumError 记录转换失败。

type NumError struct {
        Func string // the failing function (ParseBool, ParseInt, ParseUint, ParseFloat)
        Num  string // the input
        Err  error  // the reason the conversion failed (ErrRange, ErrSyntax)
}

示例

package main

import (
	"fmt"
	"strconv"
)

func main() {
	str := "Not a number"
	if _, err := strconv.ParseFloat(str, 64); err != nil {
		e := err.(*strconv.NumError)
		fmt.Println("Func:", e.Func)
		fmt.Println("Num:", e.Num)
		fmt.Println("Err:", e.Err)
		fmt.Println(err)
	}

}

func (*NumError) ErrorSource

func (e *NumError) Error() string

	转换 | strconv
	转换 | strconv	详细