View source for Zho:添加 () 为第 () 项（积木）

{{:Eng:Insert () at () of () (block)/translate}}
{{Zho/积木
|名 = 添加 () 为第 () 项
|sb = 添加 [pie] 為第 ( ) 項\( [ v] \)
|类别 = [[Zho:清单类积木|清单类积木]]
|形狀 = [[Zho:条形积木|条形积木]]
|defaults = thing; 1; the first [[Zho:清单|清单]] (alphabetized)
|加 = 1.3
}}
The '''Insert () at () of ()''' [[Zho:积木|积木]] is a [[Zho:,清单类积木|清单类积木]] and a [[Zho:条形积木|条形积木]]. The block inserts an item containing the given text into the list, at the given position. All values below the inserted item are passed onto the item beneath them; the last item's value is placed in a new item at the end of the list.

==用法示例==
[[File:Insertion.png|thumb|300px|A visual representation of adding "beever" to position 3 in a list.]]
If a [[Zho:清单|清单]] is used for holding objects in a special order and an object has to be added, using the [[Zho:新增项目 () ()（积木）|新增项目 () ()]] block would ruin the sequence{{-}}this block, however, can insert objects without ruining the order.

Some common uses for the Insert () at () of () block:
*Inserting items into a specific part of a list
<scratchblocks>
詢問 [Where should I insert it?] 並等待
添加 [pie] 為第 (詢問的答案) 項\( [favorite foods v] \)
</scratchblocks>
*Word processors that record all characters in a list, where a character is being inserted in the middle of a sentence
*Giving more precision than the [[Zho:新增项目 () ()（积木）|新增项目 () ()]] block

==应用==
This block requires a long process but is indeed workaroundable. In the following example there is a general workaround of the "insert" block.
<scratchblocks>
定義 insert (text) at (index) of (list) //run without screen refresh
刪除第 (全部 v) 項 \( [handler v] \) // this is a list used for adding to the other list
變數 [i v] 設為 (0)
重複 (字串長度\( (list) \)) 次 
  變數 [i v] 改變 (1)
  新增項目 (清單第 (i) 項項目\( (list) \) :: list) \( [handler v] \)
end // makes a copy
刪除第 (全部 v) 項 \( (list) \)
變數 [i v] 設為 (0)
重複 (清單 [handler v] 的項目數 :: list) 次 
  如果 <(i) = (index)> 那麼 
    新增項目 (text) \( (list) \)
  end
  新增項目 (清單第 (i) 項項目\( [handler v] \) :: list) \( (list) \)
end
</scratchblocks>

==参见==
*[[Zho:新增项目 () ()（积木）|Add () to ()]]
*[[Zho:替换第 () 项于 () 成 ()（积木）|替换第 () 项于 () 成 ()]]
{{Zho/数据类积木}}
[[Category:Zho/清单类积木]]