names=slice!
visibility=public
kind=defined

--- slice!(nth)       -> object | nil

指定した要素を自身から取り除き、取り除いた要素を返します。取り除く要素がなければ nil
を返します。

@param nth 取り除く要素のインデックスを整数で指定します。

例:

   a = [ "a", "b", "c" ]
   a.slice!(1)     #=> "b"
   a               #=> ["a", "c"]
   a.slice!(-1)    #=> "c"
   a               #=> ["a"]
   a.slice!(100)   #=> nil
   a               #=> ["a"]

--- slice!(start, len)  -> Array | nil
--- slice!(range)     -> Array | nil

指定した部分配列を自身から取り除き、取り除いた部分配列を返します。取り除く要素がなければ nil
を返します。

@param start 削除したい部分配列の先頭のインデックスを整数で指定します。

@param len 削除したい部分配列の長さを整数で指定します。

@param range 削除したい配列の範囲を [[c:Range]] オブジェクトで指定します。

例:

   a = [ "a", "b", "c" ]
   a.slice!(1, 2)     #=> ["b", "c"]
   a                  #=> ["a"]
   
   a = [ "a", "b", "c" ]
   a.slice!(1, 0)     #=> []
   a                  #=> [ "a", "b", "c" ]

