[SDS阅读理解/7]源码中的函数/4

每天记录几个把它记录完吧。还有20多个

       第十九个。该函数的作用是将t指向的那串字符拷贝len长度个到s中。注意是从s的首地址开始，会覆盖原来的内容。

// 作者注释/* Destructively modify the sds string 's' to hold the specified binary * safe string pointed by 't' of length 'len' bytes. */sds sdscpylen(sds s, const char *t, size_t len) {    // 调用sdsalloc()函数获取s的总申请空间，判断是否够长度    // 来储存拷贝的内容。该函数的原理前面章节有讲。    if (sdsalloc(s) < len) {        // 如果空间不够，则调用下面这个函数为s增加不够的空间        // 也就是len - sdslen(s),下面这两个函数的原理前面        // 章节有讲        s = sdsMakeRoomFor(s,len-sdslen(s));        // 申请失败就返回NULL        if (s == NULL) return NULL;    }    // 成功后拷贝内容    memcpy(s, t, len);    // 设置结尾符    s[len] = '\0';    // 设置s的实际长度，该函数原理前面章节有讲    sdssetlen(s, len);    return s;}

---

       第二十个。该函数的作用也是拷贝。

// 作者注释/* Like sdscpylen() but 't' must be a null-termined string so that the length * of the string is obtained with strlen(). */sds sdscpy(sds s, const char *t) {    // 调用上面讲的函数进行拷贝    // t必须以0结尾，才能通过strlen()来计算它的长度    return sdscpylen(s, t, strlen(t));}

---

       第二十一个。该函数的作用是将一个long long类型的整数value转换成字符串存放在s中。s指向的空间至少有21字节。函数返回该字符串的长度。

// 作者注释/* Helper for sdscatlonglong() doing the actual number -> string * conversion. 's' must point to a string with room for at least * SDS_LLSTR_SIZE bytes. * * The function returns the length of the null-terminated string * representation stored at 's'. */#define SDS_LLSTR_SIZE 21int sdsll2str(char *s, long long value) {    char *p, aux;    unsigned long long v;    size_t l;    /* Generate the string representation, this method produces     * an reversed string. */    // 将整数value转成正数，典型的( ? : )运算    v = (value < 0) ? -value : value;    // p指向s    p = s;    // 通过%和/来截取一个位上的整数，再指针偏移来储存它    // 弄懂这几个符号的作用就容易理解了    do {        *p++ = '0'+(v%10);        v /= 10;    } while(v);    // 如果value是个负数，还得加上‘-’号。注意是放后面，而不是前面    if (value < 0) *p++ = '-';    /* Compute length and add null term. */    // s指向首地址，p指向尾地址，它们两个指针相减就是    // 它们之间隔多少个字节了。    l = p-s;    // 最后面还得加个结尾符    *p = '\0';    /* Reverse the string. */    // 因为转换成字符串后是反过来的，所以得再反过来一次    // 除去结尾符    p--;    // 因为p和s都是指向同一个内存空间的，只是位置不同    // 如果不懂这里的算法，按着代码画个图就容易理解了    // 代码本身没有难的，只是过程可能难理解    while(s < p) {        aux = *s;        *s = *p;        *p = aux;        s++;        p--;    }    // 返回长度    return l;}

---

       第二十二个。该函数的原理和上一个一样，只是这个是将unsigned longlong类型(非负整数)的整数转换成字符串。代码没变，就不注释了。

// 作者注释/* Identical sdsll2str(), but for unsigned long long type. */int sdsull2str(char *s, unsigned long long v) {    char *p, aux;    size_t l;    /* Generate the string representation, this method produces     * an reversed string. */    p = s;    do {        *p++ = '0'+(v%10);        v /= 10;    } while(v);    /* Compute length and add null term. */    l = p-s;    *p = '\0';    /* Reverse the string. */    p--;    while(s < p) {        aux = *s;        *s = *p;        *p = aux;        s++;        p--;    }    return l;}

---

       第二十三个。该函数的作用还是将long long类型的整数转换成一个sds字符串。

// 作者注释/* Create an sds string from a long long value. It is much faster than: * * sdscatprintf(sdsempty(),"%lld\n", value); */sds sdsfromlonglong(long long value) {    // 需要用来临时储存字符的变量    char buf[SDS_LLSTR_SIZE];    // 调用第二十个函数将value转换成字符串存到buf    // 并获取它的长度len    int len = sdsll2str(buf,value);    // 调用sdsnewlen()这个函数创建一个sds变量    // 并将buf的内容存过去，然后将这个变量返回给我们    // 该函数的原理前面章节有讲    return sdsnewlen(buf,len);}

---

       好了，就记录到这先。:)