Go int64 与 string 互转

在日常开发中,int64 常用来保存时间戳、数据库自增主键或长订单号等大整数。如果需要在 int64 与 string 之间互转,我们可以使用标准库 strconv 包提供的 strconv.FormatInt() 和 strconv.ParseInt()。

相比前面学过的 strconv.Atoi() 和 strconv.Itoa(),这两个函数不仅原生支持 int64 类型,还能灵活指定二进制、八进制或十六进制等转换进制。

int64 转 string:strconv.FormatInt()

在 Go 语言中,把 int64 整数转换为 string 字符串,直接调用 strconv.FormatInt() 就可以了。其中,format 是 “格式化” 的意思,表示把整数按指定进制格式化为字符串。

语法:

str := strconv.FormatInt(i, base)

说明:

strconv.FormatInt() 接收以下 2 个必选参数,并直接返回转换后的 string 字符串:

  • i(必选):需要转换的 int64 类型整数。如果手头是普通的 int 变量,我们需要先通过 int64(x) 转成 int64 再传入。
  • base(必选):转换的目标进制,取值范围为 2~36。日常开发最常用的十进制固定传入 10,传入 2 转为二进制字符串,传入 16 则转为十六进制字符串。

示例 1:转为十进制字符串

package main

import (
    "fmt"
    "strconv"
)

func main() {
    var orderID int64 = 1793001002
    str := strconv.FormatInt(orderID, 10)    // 按十进制转为字符串

    fmt.Println(str)
    fmt.Printf("%T\n", str)
}

运行结果如下。

1793001002
string

分析:

strconv.FormatInt(orderID, 10) 表示将 int64 变量 orderID 按十进制转换为字符串 "1793001002"。因为整数转字符串不会失败,所以它只返回一个 string 结果。

实际上,strconv.Itoa(n) 的底层源码只有一行 return FormatInt(int64(n), 10),本质上就是对这个函数的封装。

虽然调用 fmt.Sprintf() 写成 fmt.Sprintf("%d", orderID) 也能得到同样的结果,但如果只是单纯把 int64 转成字符串,我们更推荐使用执行效率更高的 strconv.FormatInt()。

除了十进制之外,如果想把整数转换成二进制、八进制或十六进制字符串,只需要改一下第 2 个参数即可。下面我们来看一个例子。

示例 2:转为其他进制字符串

package main

import (
    "fmt"
    "strconv"
)

func main() {
    var num int64 = 255

    binStr := strconv.FormatInt(num, 2)     // 二进制
    octStr := strconv.FormatInt(num, 8)     // 八进制
    hexStr := strconv.FormatInt(num, 16)    // 十六进制

    fmt.Println("二进制:" + binStr)
    fmt.Println("八进制:" + octStr)
    fmt.Println("十六进制:" + hexStr)
}

运行结果如下。

二进制:11111111
八进制:377
十六进制:ff

分析:

在这个例子中,我们通过修改第 2 个参数 base,把十进制数 255 分别转成了二进制 "11111111"、八进制 "377" 和十六进制 "ff"。生成的十六进制字母默认都是小写的,如果需要大写形式可以再配合 strings.ToUpper() 处理。

string 转 int64:strconv.ParseInt()

反过来,当我们需要把一个数字字符串解析为 int64 整数时,可以使用 strconv.ParseInt() 函数。其中,parse 是 “解析” 的意思。

语法:

num, err := strconv.ParseInt(s, base, bitSize)

说明:

strconv.ParseInt() 接收以下 3 个必选参数,并返回 (int64, error) 两个值:

  • s(必选):需要解析的数字字符串。
  • base(必选):字符串对应的进制。按十进制解析固定传 10,按二进制传 2,按十六进制传 16。如果传入 0,函数会根据字符串前缀自动判断进制,比如 "0x" 开头按十六进制解析,"0b" 开头按二进制解析。
  • bitSize(必选):限制结果的整数位宽,可传入 0、8、16、32 或 64,分别对应 int、int8、int16、int32 和 int64 的取值范围。一旦数值超出指定位宽,函数就会返回溢出错误;日常解析为 int64 时固定传 64 即可。

示例 3:解析十进制字符串

package main

import (
    "fmt"
    "strconv"
)

func main() {
    s := "1793001002"
    num, err := strconv.ParseInt(s, 10, 64)
    if err != nil {
        fmt.Println("解析失败:", err)
        return
    }

    fmt.Println(num)
    fmt.Printf("%T\n", num)
}

运行结果如下。

1793001002
int64

分析:

strconv.ParseInt(s, 10, 64) 表示按十进制和 64 位有符号整数的范围解析字符串 "1793001002"。确认 err 为 nil 没有出错后,得到的变量 num 就是 int64 类型。

如果待解析的字符串是二进制、十六进制,或者开头带有 "0x" 前缀,第 2 个参数 base 应该怎么传呢?下面再来看一个例子。

示例 4:解析其他进制与带前缀字符串

package main

import (
    "fmt"
    "strconv"
)

func main() {
    n1, _ := strconv.ParseInt("11111111", 2, 64)    // 按二进制解析
    n2, _ := strconv.ParseInt("ff", 16, 64)         // 按十六进制解析
    n3, _ := strconv.ParseInt("0xff", 0, 64)        // 传 0 自动识别 0x 前缀

    fmt.Println(n1, n2, n3)
}

运行结果如下。

255 255 255

分析:

这里演示的都是写死的合法字符串,我们先使用 _ 忽略错误返回值,实际处理外部数据时一定要检查 err。可以看到,不带前缀的 "11111111" 和 "ff" 分别传入进制 2 和 16 后,都还原成了十进制整数 255。

而带有 "0x" 前缀的 "0xff" 必须把第 2 个参数传为 0,让函数自动识别进制。如果误传 16,函数反而会把 "0x" 当成非法字符报错。

平时解析普通十进制数据时,第 2 个参数一定要固定传入 10,不要图省事传 0。因为当 base 为 0 时,以 "0" 开头的字符串会被当成八进制(只允许数字 0~7)来解析,遇到月份 "08" 这类带前导零的字符串就会报错。

// 正确方式
n, err := strconv.ParseInt("08", 10, 64)

// 错误方式
n, err := strconv.ParseInt("08", 0, 64)

最后,很多初学者容易对第 3 个参数 bitSize 产生误解,以为传 8 就会直接返回 int8 类型。实际情况是怎样的呢?我们用下面这个例子验证一下就清楚了。

示例 5:bitSize 的范围校验与返回类型

package main

import (
    "fmt"
    "strconv"
)

func main() {
    n1, err1 := strconv.ParseInt("100", 10, 8)
    fmt.Printf("n1 = %d (%T), err1 = %v\n", n1, n1, err1)

    n2, err2 := strconv.ParseInt("200", 10, 8)
    fmt.Printf("n2 = %d, err2 = %v\n", n2, err2)
}

运行结果如下。

n1 = 100 (int64), err1 = <nil>
n2 = 127, err2 = strconv.ParseInt: parsing "200": value out of range

分析:

从运行结果可以清楚看出 bitSize 的真实作用:当传入 8 时,函数会按 int8 的范围(-128~127)做校验。

"100" 落在范围内所以解析成功,但 n1 的类型依然是 int64。而 "200" 超出了 127 上限,立即返回了 value out of range 溢出错误。

由于 Go 语言不支持函数重载,无论 bitSize 传 64、32 还是 8,strconv.ParseInt() 返回的第 1 个值永远是 int64。确认无误后,如果需要 int8 或 int32,再在外层做一次显式类型转换(如 int8(n1))就可以了。

此外,如果在开发中需要处理无符号大整数 uint64 与字符串的互转,我们可以使用 strconv.FormatUint() 和 strconv.ParseUint() 函数,它们的参数规则与上面完全相同。

strconv 包函数的命名规律

在标准库 strconv 包中,类型转换函数的命名和返回值有着非常清晰的规律,小伙伴们掌握后就不用死记硬背了:

  • Format 开头的函数:如 FormatInt()、FormatFloat()、FormatBool(),统一用于 “把其他类型转为字符串”。因为格式化不会失败,所以它们都只返回一个 string 结果。
  • Parse 开头的函数:如 ParseInt()、ParseFloat()、ParseBool(),统一用于 “把字符串解析为其他类型”。因为字符串内容可能不合法,所以它们都会返回 (目标类型, error) 两个值。
给站长反馈

绿叶网正在不断完善中,小伙伴们如果发现任何问题,还望多多给站长反馈,谢谢!

邮箱:lvyenet@vip.qq.com

「绿叶网」服务号
绿叶网服务号放大
关注服务号,微信也能看教程。
绿叶网服务号