当前位置:首页 > 文章列表 > Golang > Go问答 > Go math/big.Rat.Scan 的 %f 与 %v 为什么采用相同读取规则

Go math/big.Rat.Scan 的 %f 与 %v 为什么采用相同读取规则

来源:17golang原创 2026-11-19 07:52:35 0浏览 收藏

如果你在 fmt.Fscanf 中分别使用 %f 和 %v 读取 math/big.Rat,会发现两种写法得到的结果相同。这不是 fmt 忽略了格式字符串,而是 *big.Rat 实现的 Scan 明确把这两个动词放进了同一个支持集合。

结论:Rat.Scan 接受 e、E、f、F、g、G 和 v,官方文档说明这些格式全部等价。%f 与 %v 在这里表达的是“怎样调用扫描接口”,不是“用浮点格式或默认格式改变 Rat 的数值”。

官方资料:https://pkg.go.dev/math/big#Rat.Scan

先区分扫描动词和输出动词

同一个百分号动词出现在输入和输出场景时,语义不能直接类比。输出时,%f 通常表示不使用指数的浮点形式,%v 表示默认格式;但 Rat.Scan 的工作是从输入流中读取一个 token 并把它写入 Rat,它没有“按浮点精度输出”的任务。

因此标题中的“相同读取规则”有一个明确边界:只讨论 fmt.Scanner 调用 Rat.Scan 时传入的 verb。后续如果用 fmt.Printf 输出这个 Rat,输出动词仍然会按照格式化规则处理。

fmt Fscanf 将格式动词传给 Rat.Scan 并由支持集合决定是否继续解析的静态结构图
图1:格式动词进入 Rat.Scan 后统一分派到同一解析入口的结构示意图,不是运行截图。

用最小示例对比 %f 和 %v

下面让两个独立的 Rat 读取同一个十进制文本。代码里的注释只标出输入、目标对象和错误处理这几个关键点:

package main

import (
	"fmt"
	"math/big"
	"strings"
)

func main() {
	var fromF, fromV big.Rat

	// %f 和 %v 都通过 Rat.Scan 读取同一个输入 token。
	_, errF := fmt.Fscanf(strings.NewReader("12.50"), "%f", &fromF)
	_, errV := fmt.Fscanf(strings.NewReader("12.50"), "%v", &fromV)
	if errF != nil || errV != nil {
		// 任一输入失败都停止继续使用结果,避免把零值当成解析成功。
		panic(fmt.Errorf("scan failed: %v, %v", errF, errV))
	}

	// RatString 输出规范化后的有理数形式,便于比较两个结果。
	fmt.Println(fromF.RatString())
	fmt.Println(fromV.RatString())
}

两行都会输出 25/2。这里的等价不是把小数保存成二进制浮点数,而是把输入文本解析成精确的有理数。12.50 和 25/2 表示同一个值,RatString 只是选择了规范化后的分数形式展示。

Rat.Scan 实际检查了什么

Go 官方源码把关键流程写得很直接:先调用 ScanState.Token 读取由数字、符号、小数点和指数字符组成的 token;然后检查传入的 verb 是否属于 efgEFGv;最后把 token 交给 SetString。因此 f 和 v 只影响“动词是否合法”,并不选择两套不同的数值算法。

// Rat.Scan 的结构关系示意:输入和动词都进入同一条解析路径。
func scanRat(state fmt.ScanState, verb rune, target *big.Rat) error {
	// 只有官方支持集合中的扫描动词才允许继续。
	if !strings.ContainsRune("efgEFGv", verb) {
		return errors.New("Rat.Scan: invalid verb")
	}

	// 实际实现会从 ScanState 取得 token,再交给 Rat 的字符串解析逻辑。
	token, err := state.Token(true, ratToken)
	if err != nil {
		return err
	}
	if _, ok := target.SetString(string(token)); !ok {
		return errors.New("Rat.Scan: invalid syntax")
	}
	return nil
}

上面的代码是为了解释调用关系的简化示意,不是建议复制的完整替代实现。真正的标准库实现还包含自己的 token 谓词、错误文本和内部解析细节;读者只需要抓住一件事:支持集合中的动词最终共享同一条转换路径。

Rat.Scan 先提取输入 token 再交给 Rat 解析并返回错误或规范化结果的静态流程图
图2:输入 token、动词检查和 Rat 解析结果之间的关系示意图,不是运行截图。

哪些动词可以用,哪些会失败

不要根据输出场景的习惯给 Rat.Scan 任意添加动词。它的支持集合很小,而且大小写对应的成员也都在同一组里:

动词Rat.Scan 是否接受含义
%e、%E接受进入 Rat 的通用扫描路径
%f、%F接受与其他受支持动词采用相同读取规则
%g、%G接受不会单独启用另一种精度模式
%v接受默认扫描动词也映射到同一路径
%d、%s不接受不在 Rat.Scan 的支持集合中

例如把格式改成 %d,错误重点就不再是输入文本是否为合法有理数,而是 Rat.Scan 先拒绝了不支持的动词。排查时先看格式字符串,再看 token 内容,定位会更快。

为什么标准库选择让它们等价

Rat 的目标是表达有理数,不是保存“这次输入使用了 %f 还是 %v”。只要输入可以表示成有理数,扫描阶段最重要的是把文本交给同一个精确解析入口;如果为每个格式动词设计一套不同规则,反而会让同一个数在不同格式下产生不必要的差异。

这也解释了为什么格式动词不会改变 Rat 的精度。精度或舍入是浮点类型需要重点处理的问题,Rat 保存的是分子和分母的精确关系。想改变展示形式,应在读取完成后使用适合输出的 API,而不是期待 %f 在输入阶段触发浮点舍入。

工程上怎么选

  • 团队约定使用“默认扫描”时,可以选 %v,它能直观表达“让 Rat 使用默认支持路径”。
  • 格式模板本身已经按浮点输入字段组织时,可以用 %f,但要在注释或文档中说明对 Rat.Scan 来说它与 %v 等价。
  • 需要校验输入格式、记录更明确的错误或绕开 fmt 时,可以先读取字符串,再显式调用 Rat.SetString,把输入边界放在业务代码中。

无论选择哪个合法动词,都不要把它当作输出格式配置。输入动词只决定 Rat.Scan 是否接收这次调用;真正的数值结果来自输入 token 的解析。

相关问题

为什么 %f 读取后不是浮点数?因为目标参数是 *big.Rat,它的 Scan 负责把 token 转成有理数;动词不会把目标对象改成 float64。

%v 会让 Rat 使用默认输出格式吗?在 Rat.Scan 中不会。它只是被接受的扫描动词之一,和 %f 走同一读取规则;输出时再由 fmt.Printf 的格式决定展示方式。

输入不合法时应该先查什么?先确认格式动词是否属于 e/E/f/F/g/G/v,再检查输入 token 是否能被 Rat 解析。这样可以区分“动词不支持”和“文本语法错误”。

把这篇文章压缩成一句话:Rat.Scan 的 %f 和 %v 都是合法入口,但它们不携带不同的数值语义,最终都使用同一套有理数读取规则。

版本声明
本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
Go fmt.Formatter 为什么会覆盖默认字符串格式化Go fmt.Formatter 为什么会覆盖默认字符串格式化
上一篇
Go fmt.Formatter 为什么会覆盖默认字符串格式化
Go math/bits.Len64 为什么适合计算位图宽度
下一篇
Go math/bits.Len64 为什么适合计算位图宽度
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1107次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1099次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1270次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1212次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1059次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码