php内置函数分析之str_pad()

php内置函数分析之str_pad()

PHP_FUNCTION(str_pad)
{
    /* Input arguments */
    zend_string *input;                /* Input string 输入字符串*/
    zend_long pad_length;            /* Length to pad to 填充到多长.*/

    /* Helper variables */
    size_t num_pad_chars;        /* Number of padding characters (total - input size) 要填充进去的字符个数*/
    char *pad_str = " "; /* Pointer to padding string */
    size_t pad_str_len = 1; // 填充字符的个数 
    zend_long   pad_type_val = STR_PAD_RIGHT; /* The padding type value 填充类型,左填充、右填充、左右填充。默认右填充*/
    size_t       i, left_pad=0, right_pad=0;
    zend_string *result = NULL;    /* Resulting string 返回值*/

    if (zend_parse_parameters(ZEND_NUM_ARGS(), "Sl|sl", &input, &pad_length, &pad_str, &pad_str_len, &pad_type_val) == FAILURE) {
        return;
    }

    /* If resulting string turns out to be shorter than input string,
       we simply copy the input and return. */
    /* 如果pad_length(参数2)小于等于输入字符串的长度,则返回原始的输入字符串。*/
    if (pad_length < 0  || (size_t)pad_length <= ZSTR_LEN(input)) {
        RETURN_STRINGL(ZSTR_VAL(input), ZSTR_LEN(input));
    }

    /* 填充字符串长度为0,如:str_pad("abc", 10, ""),则Warning级别的错误。
       填充字符串的默认长度为1,即str_pad("abc", 10),的情况下pad_str_len=1。*/
    if (pad_str_len == 0) {
        php_error_docref(NULL, E_WARNING, "Padding string cannot be empty");
        return;
    }

    /*pad_type只能为STR_PAD_LEFT, STR_PAD_RIGHT, or STR_PAD_BOTH 或 0, 1, 2*/
    if (pad_type_val < STR_PAD_LEFT || pad_type_val > STR_PAD_BOTH) {
        php_error_docref(NULL, E_WARNING, "Padding type has to be STR_PAD_LEFT, STR_PAD_RIGHT, or STR_PAD_BOTH");
        return;
    }

    num_pad_chars = pad_length - ZSTR_LEN(input); // 需要被填充进去的字符的数量
    if (num_pad_chars >= INT_MAX) { // num_pad_chars的最大值是2147483647。#define INT_MAX 2147483647
        php_error_docref(NULL, E_WARNING, "Padding length is too long");
        return;
    }

    result = zend_string_safe_alloc(1, ZSTR_LEN(input), num_pad_chars, 0);
    ZSTR_LEN(result) = 0;

    /* We need to figure out the left/right padding lengths. */
    switch (pad_type_val) {
        case STR_PAD_RIGHT:
            left_pad = 0;
            right_pad = num_pad_chars;
            break;

        case STR_PAD_LEFT:
            left_pad = num_pad_chars;
            right_pad = 0;
            break;

        // 左填充数量小于右,left_pad <= right_pad
        case STR_PAD_BOTH:
            left_pad = num_pad_chars / 2;
            right_pad = num_pad_chars - left_pad;
            break;
    }

    /* First we pad on the left. */
    /* 左填充:循环添加字符 */
    for (i = 0; i < left_pad; i++)
        ZSTR_VAL(result)[ZSTR_LEN(result)++] = pad_str[i % pad_str_len];

    /* Then we copy the input string. */
    /* 左填充完成后,附加输入字符串 */
    memcpy(ZSTR_VAL(result) + ZSTR_LEN(result), ZSTR_VAL(input), ZSTR_LEN(input));
    ZSTR_LEN(result) += ZSTR_LEN(input);

    /* Finally, we pad on the right. */
    /* 右填充:循环添加字符串 */
    for (i = 0; i < right_pad; i++)
        ZSTR_VAL(result)[ZSTR_LEN(result)++] = pad_str[i % pad_str_len];

    // 添加字符串结束标志'\0'
    ZSTR_VAL(result)[ZSTR_LEN(result)] = '\0';

    // 返回新字符串
    RETURN_NEW_STR(result);
}

 

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请联系我们举报,一经查实,本站将立刻删除。

发布者:全栈程序员-站长,转载请注明出处:https://javaforall.net/112494.html原文链接:https://javaforall.net

(0)
上一篇 2021年11月6日 下午6:00
下一篇 2021年11月6日 下午7:00


相关推荐

  • 计算器原码、反码和补码和位移的一些总结

    计算器原码、反码和补码和位移的一些总结计算器原码 反码和补码的一些基础知识 来自百度百科的一些概念解释 在计算机系统中 数值一律用补码来表示和存储 原码一般是针对用户而言 补码是针对计算机的具体存储来使用 转换关系 1 正整数 负整数 转换如何转换为补码 a 正整数的补码是其二进制表示 与原码相同 例 1 9 的补码是 00001001 备注 这个 9 的补码是用 8 位 2 进制来表示的 补码表示方式很多 还有 16 位二

    2026年3月26日
    2
  • python mmap_python mmap对象[通俗易懂]

    python mmap_python mmap对象[通俗易懂]—-使用内存映射的原因为了随机访问文件的内容,使用mmap将文件映射到内存中是一个高效和优雅的方法。例如,无需打开一个文件并执行大量的seek(),read(),write()调用,只需要简单的映射文件并使用切片操作访问数据即可。内存映射一个文件并不会导致这个文件被读取到内存中。也就是说,文件并没有被复制到内存缓存或数组中。相反,操作系统仅仅为文件内容保留了一段虚拟内存。当访问文件的不同区域时…

    2025年6月2日
    3
  • 旋转的描述【1】——方向余弦矩阵

    旋转的描述【1】——方向余弦矩阵目录刚体定点旋转 1 定义 2 表示方法 2 1 方向余弦矩阵 2 2 旋转矢量 2 2 1 等效旋转矢量 2 2 2 罗德里格参数 2 3 四元数 2 4 欧拉角 3 相关转化刚体定点旋转 1 定义我们对 Markdown 编辑器进行了一些功能拓展与语法支持 除了标准的 Markdown 编辑器功能 我们增加了如下几点新功能 帮助你用它写博客 全新的界面设计 将会带来全新的写作体验 在创作中心设置你喜爱的代码高亮

    2025年11月18日
    4
  • Android Framework入门介绍

    Android Framework入门介绍framework 概述 Android 简介 nbsp nbsp nbsp Android 是一种基于 Linux 的自由及开放源代码的操作系统 主要使用于移动设备 如智能手机和平板电脑 由 Google 公司和开放手机联盟领导及开发 Android 操作系统最初由 Andy nbsp Rubin 开发 主要支持手机 2005 年 8 月由 Google 收购注资 2007 年 11 月 Google 与 84 家硬件制造商 软件开发商及电信营运商组建开放手机联盟共同

    2026年3月16日
    2
  • golang go语言 反向 websocket 代理演示代码

    golang go语言 反向 websocket 代理演示代码golanggo语言反向websocket代理演示代码通过go语言实现websocket反向代理功能packagemainimport( “fmt” “github.com/fasthttp/websocket” “github.com/valyala/fasthttp” proxy”github.com/yeqown/fasthttp-reverse-proxy” “log”)varupgraders=&websocket.FastHTTPUpgrad

    2022年7月26日
    25
  • 操作系统概念第五章部分作业题答案

    操作系统概念第五章部分作业题答案题目一:为什么对调度程序而言,区分CPU约束性进程和I/O约束性进程很重要解答:绝大多数进程可分为I/O主(放入I/O队列)或CPU主(放入就绪队列),I/O主的计算时间>CPU主。因此长期调度程序应选择一个合理的包含I/O主和CPU主的组合进程。在运行I/O操作前,I/0限制的程序只运行很少数量的计算机操作。而CPU约束程序一般来使用很多的CPU。另一方面,CPU约束程序会利用整个时间片,…

    2022年7月14日
    13

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注

关注全栈程序员社区公众号