kind=defined
names=partition
visibility=public

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

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

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

@param sep    セパレータを表す文字列か正規表現

例：

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

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

