package strconv

import "strconv"

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

Index

返回首页


  • Constants
  • Variables
  • type NumError
  • 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
    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 := `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)...)