登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  文章 >  php教程

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 保存本例切出的后缀。传入变量时不需要在调用表达式里额外写 &;方法签名中的引用声明负责更新变量。

文本、位置变量与解析结果的静态结构
原创结构说明图:输入文本和位置变量与parse关联,数值和剩余文本是不同的信息。

不要传一个字面量作为需要回写的位置参数,也不要把变量命名成“数字长度”后默认其含义。官方定义的是字符串中的偏移位置;从非零位置开始时,它是结束索引,不是本次消费的长度。

从指定位置解析并保留原始起点

如果数字之前有固定前缀,先由应用确定数字起点,再调用解析器。下面的字段规则是 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表示,应该严格比较。

重复解析不同输入为什么要重设位置?

位置参数也是输入起点;保留旧终点会改变下一次从哪里开始解析。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>