這篇文章主要介紹了關於 淺談PHP源碼二十二:關於array_splice函數,有著一定的參考價值,現在分享給大家,有需要的朋友可以參考一下
淺談PHP源碼二十二:關於array_splice函數
array_splice
(PHP 4, PHP 5)
array_splice — 把數組中的一部分去掉並用其它值取代
說明
array array_splice ( array &input, int offset [, int length [, array replacement]] )
array_splice() 把 input 數組中由 offset 和 length 指定的單元去掉,如果提供了 replacement 參數,則用 replacement 數組中的單元取代。返回一個包含有被移除單元的數組。注意 input 中的數字鍵名不被保留。
如果 offset 為正,則從 input 數組中該值指定的位移量開始移除。如果 offset 為負,則從 input 末尾倒數該值指定的位移量開始移除。
如果省略 length,則移除數組中從 offset 到結尾的所有部分。如果指定了 length 並且為正值,則移除這麼多單元。如果指定了 length 並且為負值,則移除從 offset 到數組末尾倒數 length 為止中間所有的單元。小竅門:當給出了 replacement 時要移除從 offset 到數組末尾所有單元時,用 count($input) 作為 length。
如果給出了 replacement 數組,則被移除的單元被此數組中的單元替代。如果 offset 和 length 的組合結果是不會移除任何值,則 replacement 數組中的單元將被插入到 offset 指定的位置。注意替換數組中的鍵名不保留。如果用來替換的值只是一個單元,那麼不需要給它加上 array(),除非該單元本身就是一個數組
array_splice函數調用的是php_splice函數,對於此函數的主要代碼說明如下:
/* 建立並初始化返回數組,此返回數組為php_splice的返回數組,並非array_splice的返回數組(array_splice的返回數組為removed)*/ALLOC_HASHTABLE(out_hash); zend_hash_init(out_hash, 0, NULL, ZVAL_PTR_DTOR, 0);/*將數組中從開始到offset的元素拷貝到返回數組中 */for (pos=0, p=in_hash->pListHead; pos<offset && p ; pos++, p=p->pListNext) { entry = *((zval **)p->pData); entry->refcount++;/*更新返回數組 */if (p->nKeyLength) zend_hash_quick_update(out_hash, p->arKey, p->nKeyLength, p->h, &entry, sizeof(zval *), NULL);else zend_hash_next_index_insert(out_hash, &entry, sizeof(zval *), NULL);}/* 將需要移除的元素賦值給removed,即array_splice的返回數組 */if (removed != NULL) { for ( ; pos<offset+length && p; pos++, p=p->pListNext) { entry = *((zval **)p->pData); entry->refcount++; if (p->nKeyLength) zend_hash_quick_update(*removed, p->arKey, p->nKeyLength, p->h, &entry, sizeof(zval *), NULL); else zend_hash_next_index_insert(*removed, &entry, sizeof(zval *), NULL); }} else /* 其它情況,跳過這些元素 */ for ( ; pos<offset+length && p; pos++, p=p->pListNext);/* 如果有元素需要插入,即有replacement參數 */if (list != NULL) {/* 對於每個元素,建立新的zval,拷貝並將它寫入到返回數組中*/ for (i=0; i<list_count; i++) { entry = *list[i]; entry->refcount++; zend_hash_next_index_insert(out_hash, &entry, sizeof(zval *), NULL); }}/* 拷貝剩下的元素 */for ( ; p ; p=p->pListNext) { entry = *((zval **)p->pData); entry->refcount++; if (p->nKeyLength) zend_hash_quick_update(out_hash, p->arKey, p->nKeyLength, p->h, &entry, sizeof(zval *), NULL); else zend_hash_next_index_insert(out_hash, &entry, sizeof(zval *), NULL);} /* 重設數組的遊標,相當於reset函數*/zend_hash_internal_pointer_reset(out_hash);
整個過程:
1、拷貝從開始到offset的元素到返回數組
2、移除從offset開始到offset+length的元素
3、如果有替換的元素,將新元素插入到offset後面的位置
4、將offset+length後面的函數插入到返回數組後面
5、重設數組遊標
以上就是本文的全部內容,希望對大家的學習有所協助,更多相關內容請關注topic.alibabacloud.com!