PHP NumberFormatter 怎样取得数字解析结束位置
来源:17golang原创
时间:2026-11-18 02:55:41 106浏览 收藏
将一个可修改的变量作为 NumberFormatter::parse() 的第三个参数传入,即可取得解析结束位置。这个参数同时也是输入起点:调用前赋值表示从哪里开始,调用成功后读取同一个变量,得到解析停下的位置。数值结果通过返回值取得,错误则返回 false。
官方文档:https://www.php.net/manual/en/numberformatter.parse.php
返回一个数字,只说明格式器成功解析了相应部分。若业务要求整段都是数字,还需要单独判断剩余文本。
用变量接收解析结束位置
假设导入字段是带单位的重量文本,应用希望先读取数值,再检查单位。此时不能只取返回值,还要保留位置变量。下面示例固定 en_US 与十进制样式,采用纯 ASCII 输入,展示数值和后缀的分离方式。它是原创示例,未在本文制作过程中执行。
parse($text, NumberFormatter::TYPE_DOUBLE, $position);
if ($value === false) {
// 失败时报告格式器信息,不把位置变量当成成功依据。
throw new RuntimeException($formatter->getErrorMessage());
}
printf("value=%s end=%d\n", (string) $value, $position);
// 本例限定 ASCII,因此这里可以用字节切片查看尚未消费的后缀。
$remaining = substr($text, $position);
echo 'remaining=', $remaining, PHP_EOL;
$text 是输入文本,$position 是起点与终点共用的变量,$value 保存数值,$remaining 保存本例切出的后缀。传入变量时不需要在调用表达式里额外写 &;方法签名中的引用声明负责更新变量。

不要传一个字面量作为需要回写的位置参数,也不要把变量命名成“数字长度”后默认其含义。官方定义的是字符串中的偏移位置;从非零位置开始时,它是结束索引,不是本次消费的长度。
从指定位置解析并保留原始起点
如果数字之前有固定前缀,先由应用确定数字起点,再调用解析器。下面的字段规则是 qty=数字;后续文本,保留 $start 后就能分别表达原始起点和解析终点。
parse($text, NumberFormatter::TYPE_DOUBLE, $position); if ($value === false || $position
这里 $start 只保存应用确定的起点,$position 负责接收终点。例子没有要求格式器自动跳过任意前缀,也没有把分号当成数字格式的一部分。分隔符检查属于应用规则,应在数字解析成功后进行。

把数值成功与整段消费分开判断
用 $value === false 判断错误,不能用普通真假判断,因为数字零也是合法结果。结束位置也不能替代错误判断:先确认数值成功,再根据业务要求解释终点。
| 想判断什么 | 应观察什么 | 避免的混淆 |
|---|---|---|
| 数字是否解析成功 | 返回值是否严格等于false | 把0当错误 |
| 从哪里开始 | 调用前保存的起点 | 把起点当输出 |
| 在哪里停下 | 调用后的position变量 | 把结束索引当长度 |
| 字段是否符合约定 | 剩余文本或分隔符 | 部分成功等于整段有效 |
若业务只接受完整的纯 ASCII 数字字段,可以在明确空白规则后比较终点与该文本长度;若允许单位,应继续解析并验证单位。不要通过“截掉后缀”悄悄接受原本不允许的内容。
为连续字段规定明确的读取规则
解析结束位置适合帮助应用组织后续读取,但不能代替完整文本语法。建议将区域设置、允许的前后缀、分隔符、失败策略分别写清。每次解析独立文本时重新初始化位置,避免沿用上一条输入的终点。
上述代码只在纯 ASCII 条件下使用 substr 和字节长度。含非 ASCII 数字、空白或前缀的文本,不应直接照搬这种切片方式;应先确认格式器偏移与所选切片接口的索引单位一致,再设计边界处理。位置也不是屏幕上看到的字形数量。
最后,TYPE_DOUBLE 是这里选用的数值类型;解析货币应阅读专用 parseCurrency() 文档,不能把 TYPE_CURRENCY 直接用于这个方法。本文介绍已有接口的使用方式,并非一次新版本功能发布。
可以只写parse($text, $position)吗?
不能用它接收位置。第二个参数是数值类型,位置变量在第三个参数。
解析出0为什么不能当失败?
零是有效数值,错误使用false表示,应该严格比较。
重复解析不同输入为什么要重设位置?
位置参数也是输入起点;保留旧终点会改变下一次从哪里开始解析。
-
439 收藏
-
306 收藏
-
420 收藏
-
422 收藏
-
483 收藏
-
299 收藏
-
198 收藏
-
351 收藏
-
112 收藏
-
498 收藏
-
447 收藏
-
170 收藏
-
408 收藏
-
303 收藏
-
274 收藏
-
315 收藏
-
130 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习