©
本文档使用
php.cn手册 发布
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 int32i64, 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 AppendBool
func AppendBool(dst []byte, b bool) []byte
AppendBool 根据 b 的值将“true”或“false”附加到 dst 并返回扩展缓冲区。
示例
package mainimport ("fmt""strconv")func main() {
b := []byte("bool:")
b = strconv.AppendBool(b, true)
fmt.Println(string(b))}func AppendFloat
func AppendFloat(dst []byte, f float64, fmt byte, prec, bitSize int) []byte
AppendFloat 将由 FormatFloat 生成的浮点数 f 的字符串形式附加到 dst 并返回扩展缓冲区。
示例
package mainimport ("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 AppendInt
func AppendInt(dst []byte, i int64, base int) []byte
AppendInt 将由 FormatInt 生成的整数i的字符串形式附加到 dst 并返回扩展缓冲区。
示例
package mainimport ("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 AppendQuote
func AppendQuote(dst []byte, s string) []byte
AppendQuote 将由 Quote 生成的代表 s 的双引号 Go 字符串文字附加到 dst 并返回扩展缓冲区。
示例
package mainimport ("fmt""strconv")func main() {
b := []byte("quote:")
b = strconv.AppendQuote(b, `"Fran & Freddie's Diner"`)
fmt.Println(string(b))}func AppendQuoteRune
func AppendQuoteRune(dst []byte, r rune) []byte
AppendQuoteRune 将由 QuoteRune 生成的表示符文的单引号 Go 字符文字附加到 dst 并返回扩展缓冲区。
示例
package mainimport ("fmt""strconv")func main() {
b := []byte("rune:")
b = strconv.AppendQuoteRune(b, '☺')
fmt.Println(string(b))}func AppendQuoteRuneToASCII
func AppendQuoteRuneToASCII(dst []byte, r rune) []byte
AppendQuoteRuneToASCII 将由 QuoteRuneToASCII 生成的代表该符文的单引号 Go 字符文字附加到 dst 并返回扩展缓冲区。
示例
package mainimport ("fmt""strconv")func main() {
b := []byte("rune (ascii):")
b = strconv.AppendQuoteRuneToASCII(b, '☺')
fmt.Println(string(b))}func AppendQuoteRuneToGraphic
func AppendQuoteRuneToGraphic(dst []byte, r rune) []byte
AppendQuoteRuneToGraphic 将由 QuoteRuneToGraphic 生成的表示符文的单引号 Go 字符文字附加到 dst 并返回扩展缓冲区。
func AppendQuoteToASCII
func AppendQuoteToASCII(dst []byte, s string) []byte
AppendQuoteToASCII 将由 QuoteToASCII 生成的代表 s 的双引号 Go 字符串文字附加到 dst 并返回扩展缓冲区。
示例
package mainimport ("fmt""strconv")func main() {
b := []byte("quote (ascii):")
b = strconv.AppendQuoteToASCII(b, `"Fran & Freddie's Diner"`)
fmt.Println(string(b))}func AppendQuoteToGraphic
func AppendQuoteToGraphic(dst []byte, s string) []byte
AppendQuoteToGraphic 将由 QuoteToGraphic 生成的代表 s 的双引号 Go 字符串文字附加到 dst 并返回扩展缓冲区。
func AppendUint
func AppendUint(dst []byte, i uint64, base int) []byte
AppendUint 将由 FormatUint 生成的无符号整数 i 的字符串形式附加到 dst 并返回扩展缓冲区。
示例
package mainimport ("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 Atoi
func Atoi(s string) (int, error)
Atoi 返回 ParseInt(s, 10, 0) 转换为 int 类型的结果。
示例
package mainimport ("fmt""strconv")func main() {
v := "10"if s, err := strconv.Atoi(v); err == nil {
fmt.Printf("%T, %v", s, s)}}func CanBackquote
func CanBackquote(s string) bool
CanBackquote 报告字符串 s 是否可以不改变为单行反引号字符串，而不包含 tab 以外的控制字符。
示例
package mainimport ("fmt""strconv")func main() {
fmt.Println(strconv.CanBackquote("Fran & Freddie's Diner ☺"))
fmt.Println(strconv.CanBackquote("`can't backquote this`"))}func FormatBool
func FormatBool(b bool) string
FormatBool 根据 b 的值返回“true”或“false”
示例
package mainimport ("fmt""strconv")func main() {
v := true
s := strconv.FormatBool(v)
fmt.Printf("%T, %v\n", s, s)}func FormatFloat
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 mainimport ("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 FormatInt
func FormatInt(i int64, base int) string
FormatInt 返回给定基数中的i的字符串表示，对于2 <= base <= 36.结果对于数字值> = 10使用小写字母 'a' 到 'z' 。
示例
package mainimport ("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 FormatUint
func FormatUint(i uint64, base int) string
FormatUint 返回给定基数中的 i 的字符串表示，对于2 <= base <= 36.结果对于数字值> = 10使用小写字母 'a' 到 'z' 。
示例
package mainimport ("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 IsGraphic
func IsGraphic(r rune) bool
IsGraphic 报告符文是否被 Unicode 定义为 Graphic。这些字符包括类别 L，M，N，P，S 和 Z 中的字母，标记，数字，标点，符号和空格。
func IsPrint
func IsPrint(r rune) bool
IsPrint 报告该符文是否被 Go 定义为可打印，其定义与 unicode.IsPrint 相同：字母，数字，标点，符号和 ASCII 空格。
示例
package mainimport ("fmt""strconv")func main() {
c := strconv.IsPrint('\u263a')
fmt.Println(c)
bel := strconv.IsPrint('\007')
fmt.Println(bel)}func Itoa
func Itoa(i int) string
Itoa 是 FormatInt(int64(i), 10) 的缩写。
示例
package mainimport ("fmt""strconv")func main() {
i := 10
s := strconv.Itoa(i)
fmt.Printf("%T, %v\n", s, s)}func ParseBool
func ParseBool(str string) (bool, error)
ParseBool 返回字符串表示的布尔值。它接受1，t，T，TRUE，true，True，0，f，F，FALSE，false，False。任何其他值都会返回错误。
示例
package mainimport ("fmt""strconv")func main() {
v := "true"if s, err := strconv.ParseBool(v); err == nil {
fmt.Printf("%T, %v\n", s, s)}}func ParseFloat
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 mainimport ("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 ParseInt
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 mainimport ("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 ParseUint
func ParseUint(s string, base int, bitSize int) (uint64, error)
ParseUint 就像 ParseInt，但是对于无符号数字。
示例
package mainimport ("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 Quote
func Quote(s string) string
Quote 返回一个双引号的 Go 字符串字面表示s。返回的字符串使用 Go 转义序列 (\t, \n, \xFF, \u0100) 作为 IsPrint 定义的控制字符和非可打印字符。
示例
package mainimport ("fmt""strconv")func main() {
s := strconv.Quote(`"Fran & Freddie's Diner ☺"`)
fmt.Println(s)}func QuoteRune
func QuoteRune(r rune) string
QuoteRune 返回一个表示符文的单引号 Go 字符。返回的字符串使用 Go 转义序列(\t, \n, \xFF, \u0100) 作为 IsPrint 定义的控制字符和非可打印字符。
示例
package mainimport ("fmt""strconv")func main() {
s := strconv.QuoteRune('☺')
fmt.Println(s)}func QuoteRuneToASCII
func QuoteRuneToASCII(r rune) string
QuoteRuneToASCII 返回表示符文的单引号 Go 字符。对于非 ASCII 字符和 IsPrint 定义的非可打印字符，返回的字符串使用 Go 转义序列 (\t, \n, \xFF, \u0100)。
示例
package mainimport ("fmt""strconv")func main() {
s := strconv.QuoteRuneToASCII('☺')
fmt.Println(s)}func QuoteRuneToGraphic
func QuoteRuneToGraphic(r rune) string
QuoteRuneToGraphic 返回代表符文的单引号 Go 字符。对于非 ASCII 字符和 IsGraphic 定义的非可打印字符，返回的字符串使用Go转义序列 (\t, \n, \xFF, \u0100)。
func QuoteToASCII
func QuoteToASCII(s string) string
QuoteToASCII 返回一个代表 s 的双引号 Go 字符串。对于非 ASCII 字符和 IsPrint 定义的非可打印字符，返回的字符串使用 Go 转义序列 (\t, \n, \xFF, \u0100) 。
示例
package mainimport ("fmt""strconv")func main() {
s := strconv.QuoteToASCII(`"Fran & Freddie's Diner ☺"`)
fmt.Println(s)}func QuoteToGraphic
func QuoteToGraphic(s string) string
QuoteToGraphic 返回一个代表 s 的双引号 Go 字符串。对于非 ASCII 字符和 IsGraphic 定义的非可打印字符，返回的字符串使用 Go 转义序列 (\t, \n, \xFF, \u0100)。
func Unquote
func Unquote(s string) (string, error)
Unquote 将 s 解释为单引号，双引号或反引号的 Go 字符串文字，返回引用的字符串值。（如果 s 是单引号，它将是一个 Go 字符字面量； Unquote 会返回相应的一个字符字符串。）
示例
package mainimport ("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 syntaxtest("`" + s + "`")test(`"` + s + `"`)test(`'\u263a'`)}func UnquoteChar
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; and4) an error that will be nil if the character is syntactically valid.
第二个参数 quote 指定了被解析的文字类型，因此允许使用哪个转义引号字符。如果设置为单引号，则允许序列 \'并且不允许未转义'。如果设置为双引号，则允许 \“并禁止未转义”。如果设置为零，它不允许任何转义，并允许两个引号字符显示为未转义。
示例
package mainimport ("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 NumError
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 mainimport ("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) Error
func (e *NumError) Error() string