strconv
import "strconv"
strconv包实现了基本数据类型和其字符串表示的相互转换。
Examples
const IntSize = intSize
IntSize是int或uint类型的字位数。
Variables
var ErrRange = errors.New("value out of range")
ErrRange表示超出目标类型表示范围。
var ErrSyntax = errors.New("invalid syntax")
ErrSyntax表示不符合目标类型语法。
type NumError
type NumError struct { Func string // 失败的函数(ParseBool、ParseInt、ParseUint、ParseFloat) Num string // 输入的字符串 Err error // 失败的原因(ErrRange、ErrSyntax) }
NumError表示一次失败的转换。
func (*NumError) Error
func (e *NumError) Error() string
func IsPrint
func IsPrint(r rune) bool
返回一个字符是否是可打印的,和unicode.IsPrint一样,r必须是:字母(广义)、数字、标点、符号、ASCII空格。
func CanBackquote
func CanBackquote(s string) bool
返回字符串s是否可以不被修改的表示为一个单行的、没有空格和tab之外控制字符的反引号字符串。
func Quote
func Quote(s string) string
返回字符串s在go语法下的双引号字面值表示,控制字符、不可打印字符会进行转义。(如\t,\n,\xFF,\u0100)
func QuoteToASCII
func QuoteToASCII(s string) string
返回字符串s在go语法下的双引号字面值表示,控制字符和不可打印字符、非ASCII字符会进行转义。
func QuoteRune
func QuoteRune(r rune) string
返回字符r在go语法下的单引号字面值表示,控制字符、不可打印字符会进行转义。(如\t,\n,\xFF,\u0100)
func QuoteRuneToASCII
func QuoteRuneToASCII(r rune) string
返回字符r在go语法下的单引号字面值表示,控制字符、不可打印字符、非ASCII字符会进行转义。
func Unquote
func Unquote(s string) (t string, err error)
函数假设s是一个单引号、双引号、反引号包围的go语法字符串,解析它并返回它表示的值。(如果是单引号括起来的,函数会认为s是go字符字面值,返回一个单字符的字符串)
Exampletest := 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 := `cafe\u0301` // If the string doesn't have quotes, it can't be unquoted. test(s) // invalid syntax test("`" + s + "`") test(`"` + s + `"`) test(`'\u00e9'`)
Output:
Unquote("cafe\\u0301"): invalid syntax Unquote("`cafe\\u0301`") = cafe\u0301 Unquote("\"cafe\\u0301\"") = café Unquote("'\\u00e9'") = é
func UnquoteChar
func UnquoteChar(s string, quote byte) (value rune, multibyte bool, tail string, err error)
函数假设s是一个表示字符的go语法字符串,解析它并返回四个值:
1) value,表示一个rune值或者一个byte值 2) multibyte,表示value是否是一个多字节的utf-8字符 3) tail,表示字符串剩余的部分 4) err,表示可能存在的语法错误
quote参数为单引号时,函数认为单引号是语法字符,不接受未转义的单引号;双引号时,函数认为双引号是语法字符,不接受未转义的双引号;如果是零值,函数把单引号和双引号当成普通字符。
func ParseBool
func ParseBool(str string) (value bool, err error)
返回字符串表示的bool值。它接受1、0、t、f、T、F、true、false、True、False、TRUE、FALSE;否则返回错误。
func ParseInt
func ParseInt(s string, base int, bitSize int) (i int64, err error)
返回字符串表示的整数值,接受正负号。
base指定进制(2到36),如果base为0,则会从字符串前置判断,"0x"是16进制,"0"是8进制,否则是10进制;
bitSize指定结果必须能无溢出赋值的整数类型,0、8、16、32、64 分别代表 int、int8、int16、int32、int64;返回的err是*NumErr类型的,如果语法有误,err.Error = ErrSyntax;如果结果超出类型范围err.Error = ErrRange。
func ParseUint
func ParseUint(s string, base int, bitSize int) (n uint64, err error)
ParseUint类似ParseInt但不接受正负号,用于无符号整型。
func ParseFloat
func ParseFloat(s string, bitSize int) (f float64, err error)
解析一个表示浮点数的字符串并返回其值。
如果s合乎语法规则,函数会返回最为接近s表示值的一个浮点数(使用IEEE754规范舍入)。bitSize指定了期望的接收类型,32是float32(返回值可以不改变精确值的赋值给float32),64是float64;返回值err是*NumErr类型的,语法有误的,err.Error=ErrSyntax;结果超出表示范围的,返回值f为±Inf,err.Error= ErrRange。
func FormatBool
func FormatBool(b bool) string
根据b的值返回"true"或"false"。
func FormatInt
func FormatInt(i int64, base int) string
返回i的base进制的字符串表示。base 必须在2到36之间,结果中会使用小写字母'a'到'z'表示大于10的数字。
func FormatUint
func FormatUint(i uint64, base int) string
是FormatInt的无符号整数版本。
func FormatFloat
func FormatFloat(f float64, fmt byte, prec, bitSize int) string
函数将浮点数表示为字符串并返回。
bitSize表示f的来源类型(32:float32、64:float64),会据此进行舍入。
fmt表示格式:'f'(-ddd.dddd)、'b'(-ddddp±ddd,指数为二进制)、'e'(-d.dddde±dd,十进制指数)、'E'(-d.ddddE±dd,十进制指数)、'g'(指数很大时用'e'格式,否则'f'格式)、'G'(指数很大时用'E'格式,否则'f'格式)。
prec控制精度(排除指数部分):对'f'、'e'、'E',它表示小数点后的数字个数;对'g'、'G',它控制总的数字个数。如果prec 为-1,则代表使用最少数量的、但又必需的数字来表示f。
func Atoi
func Atoi(s string) (i int, err error)
Atoi是ParseInt(s, 10, 0)的简写。
func Itoa
func Itoa(i int) string
Itoa是FormatInt(i, 10) 的简写。
func AppendBool
func AppendBool(dst []byte, b bool) []byte
等价于append(dst, FormatBool(b)...)
func AppendInt
func AppendInt(dst []byte, i int64, base int) []byte
等价于append(dst, FormatInt(I, base)...)
func AppendUint
func AppendUint(dst []byte, i uint64, base int) []byte
等价于append(dst, FormatUint(I, base)...)
func AppendFloat
func AppendFloat(dst []byte, f float64, fmt byte, prec int, bitSize int) []byte
等价于append(dst, FormatFloat(f, fmt, prec, bitSize)...)
func AppendQuote
func AppendQuote(dst []byte, s string) []byte
等价于append(dst, Quote(s)...)
func AppendQuoteToASCII
func AppendQuoteToASCII(dst []byte, s string) []byte
等价于append(dst, QuoteToASCII(s)...)
func AppendQuoteRune
func AppendQuoteRune(dst []byte, r rune) []byte
等价于append(dst, QuoteRune(r)...)
func AppendQuoteRuneToASCII
func AppendQuoteRuneToASCII(dst []byte, r rune) []byte
等价于append(dst, QuoteRuneToASCII(r)...)