小编在github有对PHP源码更详尽的诠释,查看已添加的申明

自小编在github有对PHP源码更详实的注明。感兴趣的可以扫描一下,给个star。PHP5.4源码注明。可以透过commit记录查阅已添加的注释。

本人在github有对PHP源码更详细的注释。感兴趣的可以扫描一下,给个star。PHP5.4源码注解。可以通过commit记录翻开已添加的声明。

strpos

mixed strpos ( string $haystack, mixed $needle [, int $offset = 0 ] )

要是offset内定了,查找会从offset的地方上马。offset无法为负数。

回来needle第1遍面世在haystack的地方。如若在haystack中找不到needle,则赶回FALSE。

needle,借使needle不是字符串,它会被转换来整型数值并赋值为该数值的ASCII字符。请看上边例子。

strpos

mixed strpos ( string $haystack, mixed $needle [, int $offset = 0 ] )

假定offset钦赐了,查找会从offset的岗位上马。offset不或然为负数。

回来needle第三回面世在haystack的职位。如若在haystack中找不到needle,则赶回FALSE。

needle,如果needle不是字符串,它会被转换来整型数值并赋值为该数值的ASCII字符。请看下边例子。

例子

$str = "hello";
$pos = strpos($str, 111);
// 111的ASCII值是o,因此$pos = 4

例子

$str = "hello";
$pos = strpos($str, 111);
// 111的ASCII值是o,因此$pos = 4

strpos大旨源码

if (Z_TYPE_P(needle) == IS_STRING) {
     if (!Z_STRLEN_P(needle)) {
          php_error_docref(NULL TSRMLS_CC, E_WARNING, "Empty needle");
          RETURN_FALSE;
     }

     // 调用php_memnstr函数查找needle
     found = php_memnstr(haystack + offset,
                            Z_STRVAL_P(needle),
                            Z_STRLEN_P(needle),
                            haystack + haystack_len);
 } else {
      // 如果不是字符串,转换成数字并赋值为该数字的ASCII字符。
      if (php_needle_char(needle, needle_char TSRMLS_CC) != SUCCESS) {
          RETURN_FALSE;
      }
      //设置结束字符
      needle_char[1] = 0;
      found = php_memnstr(haystack + offset,
                        needle_char,
                        1,
                        haystack + haystack_len);
}

有几许要注意的是,假使needle不是字符串的话,会调用php_needle_char函数将needle转成整型数字并转移为其ASCII值。

strpos大旨源码

if (Z_TYPE_P(needle) == IS_STRING) {
     if (!Z_STRLEN_P(needle)) {
          php_error_docref(NULL TSRMLS_CC, E_WARNING, "Empty needle");
          RETURN_FALSE;
     }

     // 调用php_memnstr函数查找needle
     found = php_memnstr(haystack + offset,
                            Z_STRVAL_P(needle),
                            Z_STRLEN_P(needle),
                            haystack + haystack_len);
 } else {
      // 如果不是字符串,转换成数字并赋值为该数字的ASCII字符。
      if (php_needle_char(needle, needle_char TSRMLS_CC) != SUCCESS) {
          RETURN_FALSE;
      }
      //设置结束字符
      needle_char[1] = 0;
      found = php_memnstr(haystack + offset,
                        needle_char,
                        1,
                        haystack + haystack_len);
}

有有个别要留心的是,如若needle不是字符串的话,会调用php_needle_char函数将needle转成整型数字并转换为其ASCII值。

探寻函数

函数最终回来的是found,php_memnstr函数完毕了搜索的办法。那么再持续看看php_memnstr函数做了怎么样:

#define php_memnstr zend_memnstr

php_memnstr是函数zend_memnstr的宏定义,查看zend_memnstr函数如下:

static inline char *
zend_memnstr(char *haystack, char *needle, int needle_len, char *end)
{
    char *p = haystack;
    char ne = needle[needle_len-1];
    if (needle_len == 1) {
        return (char *)memchr(p, *needle, (end-p));
    }

    if (needle_len > end-haystack) {
        return NULL;
    }

    // 第一个优化,只查找end - needle_len次
    end -= needle_len;

    while (p <= end) {
        // 第二个优化,先判断字符串的开头和结尾是否一样再判断整个字符串
        if ((p = (char *)memchr(p, *needle, (end-p+1))) && ne == p[needle_len-1]) {
            if (!memcmp(needle, p, needle_len-1)) {
                return p;
            }
        }

        if (p == NULL) {
            return NULL;
        }

        p++;
    }

    return NULL;
}

end原来指向\0字符,然后end –
needle_len,即使前边部分是needle,就绝不继续移动,由此只相比end –
needle_len次。

追寻函数

函数最终回到的是found,php_memnstr函数达成了寻找的艺术。那么再持续看看php_memnstr函数做了什么样:

#define php_memnstr zend_memnstr

php_memnstr是函数zend_memnstr的宏定义,查看zend_memnstr函数如下:

static inline char *
zend_memnstr(char *haystack, char *needle, int needle_len, char *end)
{
    char *p = haystack;
    char ne = needle[needle_len-1];
    if (needle_len == 1) {
        return (char *)memchr(p, *needle, (end-p));
    }

    if (needle_len > end-haystack) {
        return NULL;
    }

    // 第一个优化,只查找end - needle_len次
    end -= needle_len;

    while (p <= end) {
        // 第二个优化,先判断字符串的开头和结尾是否一样再判断整个字符串
        if ((p = (char *)memchr(p, *needle, (end-p+1))) && ne == p[needle_len-1]) {
            if (!memcmp(needle, p, needle_len-1)) {
                return p;
            }
        }

        if (p == NULL) {
            return NULL;
        }

        p++;
    }

    return NULL;
}

end原来指向\0字符,然后end –
needle_len,纵然后边部分是needle,就不用继续移动,因而只比较end –
needle_len次。

strstr

string strstr ( string $haystack, mixed $needle [, bool $before_needle = false ] )

回到needle在haystack中第2遍面世的职务到截至的字符串。

以此函数的分别轻重缓急写的。

若是needle在haystack中不存在,重临FALSE。

如果before_needle为true,则赶回haystack中needle在haystack第两回面世的职分此前的字符串。

strstr

string strstr ( string $haystack, mixed $needle [, bool $before_needle = false ] )

归来needle在haystack中第三回现身的职位到停止的字符串。

那么些函数的区分轻重缓急写的。

假设needle在haystack中不设有,重回FALSE。

如果before_needle为true,则赶回haystack中needle在haystack第二遍出现的职位此前的字符串。

strstr宗旨源码

if (found) {
        // 计算出found的位置
        found_offset = found - haystack;
        if (part) {
            RETURN_STRINGL(haystack, found_offset, 1);
        } else {
            RETURN_STRINGL(found, haystack_len - found_offset, 1);
        }
    }

strstr函数的前半片段跟strpos类似,分歧在于strstr函数在找到地点后,要求重临haystack部分的字符串。part变量就是调用strstr函数时传递的before_needle变量。

strstr大旨源码

if (found) {
        // 计算出found的位置
        found_offset = found - haystack;
        if (part) {
            RETURN_STRINGL(haystack, found_offset, 1);
        } else {
            RETURN_STRINGL(found, haystack_len - found_offset, 1);
        }
    }

strstr函数的前半有的跟strpos类似,差异在于strstr函数在找到地方后,须求回到haystack部分的字符串。part变量就是调用strstr函数时传递的before_needle变量。

stripos

mixed stripos ( string $haystack, string $needle [, int $offset = 0 ] )

不区分轻重缓急写的strpos。完毕方式跟下边的近乎,重如果使用一份拷贝然后将索要相比较的字符串转换到小写字符后举办再举行搜索。

stripos

mixed stripos ( string $haystack, string $needle [, int $offset = 0 ] )

不区分轻重缓急写的strpos。达成方式跟下边的好像,重即使应用一份拷贝然后将需要相比的字符串转换到小写字符后举办再举办搜索。

stristr

string stristr ( string $haystack, mixed $needle [, bool $before_needle = false ] )

不区分轻重缓急写的strstr。

stristr

string stristr ( string $haystack, mixed $needle [, bool $before_needle = false ] )

不区分轻重缓急写的strstr。

宗旨源码

// 拷贝一份haystack
     haystack_dup = estrndup(haystack, haystack_len);

    if (Z_TYPE_P(needle) == IS_STRING) {
        char *orig_needle;
        if (!Z_STRLEN_P(needle)) {
            php_error_docref(NULL TSRMLS_CC, E_WARNING, "Empty needle");
            efree(haystack_dup);
            RETURN_FALSE;
        }
        orig_needle = estrndup(Z_STRVAL_P(needle), Z_STRLEN_P(needle));
        // 调用php_stristr函数找出orig_needle的值。
        found = php_stristr(haystack_dup, orig_needle,    haystack_len, Z_STRLEN_P(needle));
        efree(orig_needle);
    } else {
        if (php_needle_char(needle, needle_char TSRMLS_CC) != SUCCESS) {
            efree(haystack_dup);
            RETURN_FALSE;
        }
        needle_char[1] = 0;

        found = php_stristr(haystack_dup, needle_char,    haystack_len, 1);
    }

    if (found) {
        found_offset = found - haystack_dup;
        if (part) {
            RETVAL_STRINGL(haystack, found_offset, 1);
        } else {
            RETVAL_STRINGL(haystack + found_offset, haystack_len - found_offset, 1);
        }
    } else {
        RETVAL_FALSE;
    }

    // 释放变量
    efree(haystack_dup);

可以驾驭,found是从php_stristr中取得的,继续查看php_stristr函数:

PHPAPI char *php_stristr(char *s, char *t, size_t s_len, size_t t_len)
{
    php_strtolower(s, s_len);
    php_strtolower(t, t_len);
    return php_memnstr(s, t, t_len, s + s_len);
}

以此函数的效应就是将字符串都转成小写之后调用php_mennstr函数来寻找needle在haystack第两遍面世的职责。

骨干源码

// 拷贝一份haystack
     haystack_dup = estrndup(haystack, haystack_len);

    if (Z_TYPE_P(needle) == IS_STRING) {
        char *orig_needle;
        if (!Z_STRLEN_P(needle)) {
            php_error_docref(NULL TSRMLS_CC, E_WARNING, "Empty needle");
            efree(haystack_dup);
            RETURN_FALSE;
        }
        orig_needle = estrndup(Z_STRVAL_P(needle), Z_STRLEN_P(needle));
        // 调用php_stristr函数找出orig_needle的值。
        found = php_stristr(haystack_dup, orig_needle,    haystack_len, Z_STRLEN_P(needle));
        efree(orig_needle);
    } else {
        if (php_needle_char(needle, needle_char TSRMLS_CC) != SUCCESS) {
            efree(haystack_dup);
            RETURN_FALSE;
        }
        needle_char[1] = 0;

        found = php_stristr(haystack_dup, needle_char,    haystack_len, 1);
    }

    if (found) {
        found_offset = found - haystack_dup;
        if (part) {
            RETVAL_STRINGL(haystack, found_offset, 1);
        } else {
            RETVAL_STRINGL(haystack + found_offset, haystack_len - found_offset, 1);
        }
    } else {
        RETVAL_FALSE;
    }

    // 释放变量
    efree(haystack_dup);

能够知晓,found是从php_stristr中拿到的,继续翻看php_stristr函数:

PHPAPI char *php_stristr(char *s, char *t, size_t s_len, size_t t_len)
{
    php_strtolower(s, s_len);
    php_strtolower(t, t_len);
    return php_memnstr(s, t, t_len, s + s_len);
}

其一函数的效果就是将字符串都转成小写之后调用php_mennstr函数来查找needle在haystack第六遍面世的地点。

总结

因为strpos/stripos重返的是岗位,地方从0起始估算,所以判断查找未果都用  === FALSE 更合乎。

读书PHP的源码收获挺多,一方面可以领略某些函数的切实落到实处原理是如何的,另一方面可以学习到部分编程优化方案。

 

到此本文甘休,若是还有怎么着疑点照旧提议,可以多多沟通,原创小说,文笔有限,才疏学浅,文中若有不正之处,万望告知。

假若本文对您有接济,望点下推荐,多谢^_^

 

末段再安利一下,作者在github有对PHP源码更详尽的注释。感兴趣的可以扫描一下,给个star。PHP5.4源码声明。可以经过commit记录翻看已添加的笺注。

越来越多源码小说,欢迎访问个人主页继续查看:hoohack

总结

因为strpos/stripos重回的是岗位,地方从0发轫推断,所以判断查找未果都用  === FALSE 更适合。

开卷PHP的源码收获挺多,一方面可以了然有个别函数的求实完结原理是何等的,另一方面可以学学到有的编程优化方案。

 

到此本文为止,假若还有啥样疑难依然提出,可以多多互换,原创小说,文笔有限,才疏学浅,文中若有不正之处,万望告知。

一旦本文对您有帮扶,望点下推荐,多谢^_^

 

最终再安利一下,小编在github有对PHP源码更详细的笺注。感兴趣的可以扫描一下,给个star。PHP5.4源码注明。可以因而commit记录查看已添加的诠释。

越多源码文章,欢迎访问个人主页继续查看:hoohack