這篇文章主要介紹了關於 淺談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、重置數組遊標
以上就是本文的全部內容,希望對大家的學習有幫助,更多相關內容請關注PHP中文網!
相關推薦:
#淺聊PHP源碼二十:關於array_flip,array_reverse函數
以上是淺談PHP源碼二十二:關於array_splice函數的詳細內容。更多資訊請關注PHP中文網其他相關文章!