// File: /workspace/github_c_makefile_star2_O3/nilyang[P]redis-tdd-annotation/src/ziplist.c
// Function: _ziplistInsert
static unsigned char *__ziplistInsert(unsigned char *zl, unsigned char *p, unsigned char *s, unsigned int slen) {
    // 记录当前 ziplist 的长度
    size_t curlen = intrev32ifbe(ZIPLIST_BYTES(zl)), reqlen, prevlen = 0;
    size_t offset;
    int nextdiff = 0;
    unsigned char encoding = 0;
    long long value = 123456789; /* initialized to avoid warning. Using a value
                                    that is easy to see if for some reason
                                    we use it uninitialized. */
    zlentry entry, tail;

    /* Find out prevlen for the entry that is inserted. */
    if (p[0] != ZIP_END) {
        // 如果 p[0] 不指向列表末端，说明列表非空，并且 p 正指向列表的其中一个节点
        // 那么取出 p 所指向节点的信息，并将它保存到 entry 结构中
        // 然后用 prevlen 变量记录前置节点的长度
        // （当插入新节点之后 p 所指向的节点就成了新节点的前置节点）
        // T = O(1)
        entry = zipEntry(p);
        prevlen = entry.prevrawlen;
    } else {
        // 如果 p 指向表尾末端，那么程序需要检查列表是否为：
        // 1)如果 ptail 也指向 ZIP_END ，那么列表为空；
        // 2)如果列表不为空，那么 ptail 将指向列表的最后一个节点。
        unsigned char *ptail = ZIPLIST_ENTRY_TAIL(zl);
        if (ptail[0] != ZIP_END) {
            // 表尾节点为新节点的前置节点

            // 取出表尾节点的长度
            // T = O(1)
            prevlen = zipRawEntryLength(ptail);
        }
    }

    /* See if the entry can be encoded */
    // 尝试看能否将输入字符串转换为整数，如果成功的话：
    // 1)value 将保存转换后的整数值
    // 2)encoding 则保存适用于 value 的编码方式
    // 无论使用什么编码， reqlen 都保存节点值的长度
    // T = O(N)
    if (zipTryEncoding(s,slen,&value,&encoding)) {
        /* 'encoding' is set to the appropriate integer encoding */
        reqlen = zipIntSize(encoding);
    } else {
        /* 'encoding' is untouched, however zipEncodeLength will use the
         * string length to figure out how to encode it. */
        reqlen = slen;
    }
    /* We need space for both the length of the previous entry and
     * the length of the payload. */
    // 计算编码前置节点的长度所需的大小
    // T = O(1)
    reqlen += zipPrevEncodeLength(NULL,prevlen);
    // 计算编码当前节点值所需的大小
    // T = O(1)
    reqlen += zipEncodeLength(NULL,encoding,slen);

    /* When the insert position is not equal to the tail, we need to
     * make sure that the next entry can hold this entry's length in
     * its prevlen field. */
    // 只要新节点不是被添加到列表末端，
    // 那么程序就需要检查看 p 所指向的节点（的 header）能否编码新节点的长度。
    // nextdiff 保存了新旧编码之间的字节大小差，如果这个值大于 0 
    // 那么说明需要对 p 所指向的节点（的 header ）进行扩展
    // T = O(1)
    nextdiff = (p[0] != ZIP_END) ? zipPrevLenByteDiff(p,reqlen) : 0;

    /* Store offset because a realloc may change the address of zl. */
    // 因为重分配空间可能会改变 zl 的地址
    // 所以在分配之前，需要记录 zl 到 p 的偏移量，然后在分配之后依靠偏移量还原 p 
    offset = p-zl;
    // curlen 是 ziplist 原来的长度
    // reqlen 是整个新节点的长度
    // nextdiff 是新节点的后继节点扩展 header 的长度（要么 0 字节，要么 4 个字节）
    // T = O(N)
    zl = ziplistResize(zl,curlen+reqlen+nextdiff);
    p = zl+offset;

    /* Apply memory move when necessary and update tail offset. */
    if (p[0] != ZIP_END) {
        // 新元素之后还有节点，因为新元素的加入，需要对这些原有节点进行调整

        /* Subtract one because of the ZIP_END bytes */
        // 移动现有元素，为新元素的插入空间腾出位置
        // T = O(N)
        memmove(p+reqlen,p-nextdiff,curlen-offset-1+nextdiff);

        /* Encode this entry's raw length in the next entry. */
        // 将新节点的长度编码至后置节点
        // p+reqlen 定位到后置节点
        // reqlen 是新节点的长度
        // T = O(1)
        zipPrevEncodeLength(p+reqlen,reqlen);

        /* Update offset for tail */
        // 更新到达表尾的偏移量，将新节点的长度也算上
        ZIPLIST_TAIL_OFFSET(zl) =
            intrev32ifbe(intrev32ifbe(ZIPLIST_TAIL_OFFSET(zl))+reqlen);

        /* When the tail contains more than one entry, we need to take
         * "nextdiff" in account as well. Otherwise, a change in the
         * size of prevlen doesn't have an effect on the *tail* offset. */
        // 如果新节点的后面有多于一个节点
        // 那么程序需要将 nextdiff 记录的字节数也计算到表尾偏移量中
        // 这样才能让表尾偏移量正确对齐表尾节点
        // T = O(1)
        tail = zipEntry(p+reqlen);
        if (p[reqlen+tail.headersize+tail.len] != ZIP_END) {
            ZIPLIST_TAIL_OFFSET(zl) =
                intrev32ifbe(intrev32ifbe(ZIPLIST_TAIL_OFFSET(zl))+nextdiff);
        }
    } else {
        /* This element will be the new tail. */
        // 新元素是新的表尾节点
        ZIPLIST_TAIL_OFFSET(zl) = intrev32ifbe(p-zl);
    }

    /* When nextdiff != 0, the raw length of the next entry has changed, so
     * we need to cascade the update throughout the ziplist */
    // 当 nextdiff != 0 时，新节点的后继节点的（header 部分）长度已经被改变，
    // 所以需要级联地更新后续的节点
    if (nextdiff != 0) {
        offset = p-zl;
        // T  = O(N^2)
        zl = __ziplistCascadeUpdate(zl,p+reqlen);
        p = zl+offset;
    }

    /* Write the entry */
    // 一切搞定，将前置节点的长度写入新节点的 header
    p += zipPrevEncodeLength(p,prevlen);
    // 将节点值的长度写入新节点的 header
    p += zipEncodeLength(p,encoding,slen);
    // 写入节点值
    if (ZIP_IS_STR(encoding)) {
        // T = O(N)
        memcpy(p,s,slen);
    } else {
        // T = O(1)
        zipSaveInteger(p,value,encoding);
    }

    // 更新列表的节点数量计数器
    // T = O(1)
    ZIPLIST_INCR_LENGTH(zl,1);

    return zl;
}

// Assembly:
pushq %rbp
pushq %r15
pushq %r14
pushq %r13
pushq %r12
pushq %rbx
subq $0x58, %rsp
movl %ecx, %ebx
movq %rdx, %r14
movq %rsi, %rbp
movq %rdi, %r12
movl (%rdi), %r13d
movb $0x0, 0x7(%rsp)
movq $0x75bcd15, 0x28(%rsp)  # imm = 0x75BCD15
cmpb $-0x1, (%rsi)
je 0x2bec5
leaq 0x30(%rsp), %r15
movq %r15, %rdi
movq %rbp, %rsi
callq 0x2c336
movl 0x4(%r15), %eax
jmp 0x2bedd
movl 0x4(%r12), %edi
cmpb $-0x1, (%r12,%rdi)
je 0x2bfa6
addq %r12, %rdi
callq 0x2c46a
movl %eax, 0x8(%rsp)
leaq 0x28(%rsp), %rdx
leaq 0x7(%rsp), %r15
movq %r14, %rdi
movl %ebx, %esi
movq %r15, %rcx
callq 0x2c995
movb (%r15), %dl
movzbl %dl, %esi
testl %eax, %eax
movl %ebx, 0xc(%rsp)
je 0x2bf3b
xorl %eax, %eax
cmpl $0xdf, %esi
jle 0x2bf8f
cmpl $0xe0, %esi
je 0x2bfb3
cmpl $0xf0, %esi
je 0x2bfba
movl $0x1, %ecx
cmpl $0xfe, %esi
je 0x2bfc6
jmp 0x2bf3d
movl %ebx, %eax
xorl %ecx, %ecx
cmpl $0xfe, 0x8(%rsp)
setb 0x5(%rsp)
setae %cl
leal 0x1(,%rcx,4), %ecx
movq %rcx, 0x18(%rsp)
leaq (%rcx,%rax), %rbx
movl $0x1, %eax
movb $0x1, %cl
cmpb $-0x41, %dl
ja 0x2bfef
movl 0xc(%rsp), %ecx
cmpl $0x40, %ecx
jb 0x2bf8b
xorl %eax, %eax
cmpl $0x4000, %ecx           # imm = 0x4000
setae %al
leaq (%rax,%rax,2), %rax
addq $0x2, %rax
xorl %ecx, %ecx
jmp 0x2bfef
cmpl $0xc0, %esi
je 0x2bfc1
cmpl $0xd0, %esi
jne 0x2bf3d
movl $0x4, %ecx
jmp 0x2bfc6
movl $0x0, 0x8(%rsp)
jmp 0x2bee1
movl $0x8, %ecx
jmp 0x2bfc6
movl $0x3, %ecx
jmp 0x2bfc6
movl $0x2, %ecx
xorl %eax, %eax
cmpl $0xfe, 0x8(%rsp)
setb 0x5(%rsp)
setae %al
leal 0x1(,%rax,4), %eax
movq %rax, 0x18(%rsp)
leaq (%rax,%rcx), %rbx
movl $0x1, %eax
movb $0x1, %cl
movl %ecx, 0x10(%rsp)
movq %r14, 0x50(%rsp)
addq %rax, %rbx
movb (%rbp), %al
cmpb $-0x1, %al
movb %dl, 0x6(%rsp)
movl %esi, 0x14(%rsp)
je 0x2c02a
xorl %ecx, %ecx
cmpb $-0x2, %al
setne %cl
negl %ecx
orl $-0x5, %ecx
xorl %eax, %eax
cmpl $0xfe, %ebx
setae %al
leal (%rcx,%rax,4), %r14d
incl %r14d
jmp 0x2c02d
xorl %r14d, %r14d
subq %r12, %rbp
movq %rbp, 0x20(%rsp)
leal (%rbx,%r13), %ebp
leal (%r14,%rbp), %r15d
movq %r12, %rdi
movq %r15, %rsi
callq 0x29a61
movq %rax, %r12
movl %r15d, (%rax)
leal (%r14,%rbp), %eax
decl %eax
movq 0x20(%rsp), %rbp
movb $-0x1, (%r12,%rax)
leaq (%r12,%rbp), %r15
cmpb $-0x1, (%r12,%rbp)
je 0x2c099
movslq %r14d, %rax
movq %rbp, %rcx
leaq (%r15,%rbx), %rbp
movq %r15, %rsi
subq %rax, %rsi
notq %rcx
addq %rax, %rcx
addq %rcx, %r13
movq %rbp, %rdi
movq %r13, %rdx
callq 0x1f780
cmpl $0xfd, %ebx
ja 0x2c0a0
movl %ebx, %eax
jmp 0x2c0a5
movl %ebp, 0x4(%r12)
jmp 0x2c0d8
movl %ebx, 0x1(%rbp)
movb $-0x2, %al
movb %al, (%rbp)
addl %ebx, 0x4(%r12)
leaq 0x30(%rsp), %r13
movq %r13, %rdi
movq %rbp, %rsi
callq 0x2c336
movl 0xc(%r13), %eax
movl 0x10(%r13), %ecx
addq %rbp, %rcx
cmpb $-0x1, (%rax,%rcx)
movq 0x20(%rsp), %rbp
je 0x2c0d8
addl %r14d, 0x4(%r12)
testl %r14d, %r14d
je 0x2c0f9
addq %rbx, %r15
movq %r12, %rdi
movq %r15, %rsi
callq 0x2cdd2
testq %rax, %rax
je 0x2c129
movq %rax, %r12
addq %rax, %rbp
movq %rbp, %r15
movl 0xc(%rsp), %ebx
movl 0x10(%rsp), %ecx
cmpb $0x0, 0x5(%rsp)
je 0x2c116
movl 0x8(%rsp), %eax
movb %al, (%r15)
movl $0x1, %eax
jmp 0x2c13c
movb $-0x2, (%r15)
movl 0x8(%rsp), %eax
movl %eax, 0x1(%r15)
movl $0x5, %eax
jmp 0x2c13c
xorl %r12d, %r12d
xorl %r15d, %r15d
movl 0xc(%rsp), %ebx
movl 0x10(%rsp), %ecx
movq 0x18(%rsp), %rax
movl %eax, %r14d
addq %r15, %r14
testb %cl, %cl
je 0x2c18b
movb 0x6(%rsp), %cl
movb %cl, (%r14)
movq 0x28(%rsp), %rax
movl 0x14(%rsp), %edx
cmpl $0xdf, %edx
jle 0x2c1bb
cmpl $0xe0, %edx
je 0x2c246
cmpl $0xf0, %edx
je 0x2c24c
cmpl $0xfe, %edx
jne 0x2c261
movb %al, 0x1(%r14)
jmp 0x2c220
cmpl $0x3f, %ebx
ja 0x2c19c
movb %bl, 0x30(%rsp)
movl $0x1, %r15d
jmp 0x2c1fe
cmpl $0x3fff, %ebx           # imm = 0x3FFF
ja 0x2c1d9
movl %ebx, %eax
shrl $0x8, %eax
orb $0x40, %al
movb %al, 0x30(%rsp)
movb %bl, 0x31(%rsp)
movl $0x2, %r15d
jmp 0x2c1fe
cmpl $0xc0, %edx
je 0x2c25a
cmpl $0xd0, %edx
jne 0x2c261
movl %eax, 0x1(%r14)
jmp 0x2c220
movb $-0x80, 0x30(%rsp)
movl %ebx, %eax
shrl $0x18, %eax
movb %al, 0x31(%rsp)
movl %ebx, %eax
shrl $0x10, %eax
movb %al, 0x32(%rsp)
movb %bh, 0x33(%rsp)
movb %bl, 0x34(%rsp)
movl $0x5, %r15d
leaq 0x30(%rsp), %rsi
movq %r14, %rdi
movq %r15, %rdx
callq 0x1fbd0
addq %r15, %r14
movl %ebx, %edx
movq %r14, %rdi
movq 0x50(%rsp), %rsi
callq 0x1fbd0
movzwl 0x8(%r12), %eax
cmpw $-0x1, %ax
je 0x2c234
incl %eax
movw %ax, 0x8(%r12)
movq %r12, %rax
addq $0x58, %rsp
popq %rbx
popq %r12
popq %r13
popq %r14
popq %r15
popq %rbp
retq
movq %rax, 0x1(%r14)
jmp 0x2c220
movw %ax, 0x1(%r14)
shrl $0x10, %eax
movb %al, 0x3(%r14)
jmp 0x2c220
movw %ax, 0x1(%r14)
jmp 0x2c220
addb $0xf, %cl
cmpb $0xe, %cl
jb 0x2c220
leaq 0x6d08c(%rip), %rdi     # 0x992fc
leaq 0x6aa3e(%rip), %rsi     # 0x96cb5
movl $0x2ab, %edx            # imm = 0x2AB
callq 0x4ca32
movl $0x1, %edi
callq 0x1f3b0