php内置函数分析之array_combine()

PHP_FUNCTION(array_combine)
{
    HashTable *values, *keys;
    uint32_t pos_values = 0;
    zval *entry_keys, *entry_values;
    int num_keys, num_values;

    // 创建一个数组，用一个数组的值作为其键名，另一个数组的值作为其值
    if (zend_parse_parameters(ZEND_NUM_ARGS(), "hh", &keys, &values) == FAILURE) {
        return;
    }
    
    // 第一个数组的元素个数
    num_keys = zend_hash_num_elements(keys);
    // 第二个数组的元素个数
    num_values = zend_hash_num_elements(values);

    // 两个数组的元素个数必须一致
    if (num_keys != num_values) {
        php_error_docref(NULL, E_WARNING, "Both parameters should have an equal number of elements");
        RETURN_FALSE;
    }

    // 初始化返回值（数组）
    array_init_size(return_value, num_keys);
    
    // 空数组，函数中止
    if (!num_keys) {
        return;
    }
    // 循环遍历第一个数组
    ZEND_HASH_FOREACH_VAL(keys, entry_keys) {
        /* 通过pos_value从前向后取第一个数组和第二个数组的元素值，直到数组尾 
        *  每次取出元素后组成键值对，插入返回数组。
        */
        while (1) {
            if (pos_values >= values->nNumUsed) {
                break;
            } else if (Z_TYPE(values->arData[pos_values].val) != IS_UNDEF) {
                entry_values = &values->arData[pos_values].val;
                if (Z_TYPE_P(entry_keys) == IS_LONG) {
                    entry_values = zend_hash_index_update(Z_ARRVAL_P(return_value),
                        Z_LVAL_P(entry_keys), entry_values);
                } else {
                    zend_string *key = zval_get_string(entry_keys);
                    entry_values = zend_symtable_update(Z_ARRVAL_P(return_value),
                        key, entry_values);
                    zend_string_release(key);
                }
                zval_add_ref(entry_values);
                pos_values++;
                break;
            }
            pos_values++;
        }
    } ZEND_HASH_FOREACH_END();
}