package strconv

import “strconv”

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

Index 返回首页

Constants Variables type NumError func (e *NumError) Error() string func IsPrint(r rune) bool func CanBackquote(s string) bool func Quote(s string) string func QuoteToASCII(s string) string func QuoteRune(r rune) string func QuoteRuneToASCII(r rune) string func Unquote(s string) (t string, err error) func UnquoteChar(s string, quote byte) (value rune, multibyte bool, tail string, err error) func ParseBool(str string) (value bool, err error) func ParseInt(s string, base int, bitSize int) (i int64, err error) func ParseUint(s string, base int, bitSize int) (n uint64, err error) func ParseFloat(s string, bitSize int) (f float64, err error) func FormatBool(b bool) string func FormatInt(i int64, base int) string func FormatUint(i uint64, base int) string func FormatFloat(f float64, fmt byte, prec, bitSize int) string func Atoi(s string) (i int, err error) func Itoa(i int) string func AppendBool(dst []byte, b bool) []byte func AppendInt(dst []byte, i int64, base int) []byte func AppendUint(dst []byte, i uint64, base int) []byte func AppendFloat(dst []byte, f float64, fmt byte, prec int, bitSize int) []byte func AppendQuote(dst []byte, s string) []byte func AppendQuoteToASCII(dst []byte, s string) []byte func AppendQuoteRune(dst []byte, r rune) []byte func AppendQuoteRuneToASCII(dst []byte, r rune) []byte Examples

返回首页

Unquote Constants 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字符字面值,返回一个单字符的字符串)

Example 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)…)