names=partition
visibility=public
kind=defined

--- partition(sep) -> [String, String, String]

セパレータ sep が最初に登場する部分で self を 3 つに分割し、
[最初のセパレータより前の部分, セパレータ, それ以降の部分]
の 3 要素の配列を返します。

self がセパレータを含まないときは、
返り値の第 2 要素と第 3 要素が空文字列になります。

@param sep    セパレータを表す文字列か正規表現を指定します。

例：

  p "axaxa".partition("x")   # => ["a", "x", "axa"]
  p "aaaaa".partition("x")   # => ["aaaaa", "", ""]
  p "aaaaa".partition("")    # => ["", "", "aaaaa"]

@see [[m:String#rpartition]], [[m:String#split]]

