1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
|
Returns a 3-element array of substrings of +self+.
If +pattern+ is matched, returns the array:
[pre_match, first_match, post_match]
where:
- +first_match+ is the first-found matching substring.
- +pre_match+ and +post_match+ are the preceding and following substrings.
If +pattern+ is not matched, returns the array:
[self.dup, "", ""]
Note that in the examples below, a returned string <tt>'hello'</tt>
is a copy of +self+, not +self+.
If +pattern+ is a Regexp, performs the equivalent of <tt>self.match(pattern)</tt>
(also setting {matched-data variables}[rdoc-ref:language/globals.md@Matched+Data]):
'hello'.partition(/h/) # => ["", "h", "ello"]
'hello'.partition(/l/) # => ["he", "l", "lo"]
'hello'.partition(/l+/) # => ["he", "ll", "o"]
'hello'.partition(/o/) # => ["hell", "o", ""]
'hello'.partition(/^/) # => ["", "", "hello"]
'hello'.partition(//) # => ["", "", "hello"]
'hello'.partition(/$/) # => ["hello", "", ""]
'hello'.partition(/x/) # => ["hello", "", ""]
If +pattern+ is not a Regexp, converts it to a string (if it is not already one),
then performs the equivalent of <tt>self.index(pattern)</tt>
(and does _not_ set {matched-data global variables}[rdoc-ref:language/globals.md@Matched+Data]):
'hello'.partition('h') # => ["", "h", "ello"]
'hello'.partition('l') # => ["he", "l", "lo"]
'hello'.partition('ll') # => ["he", "ll", "o"]
'hello'.partition('o') # => ["hell", "o", ""]
'hello'.partition('') # => ["", "", "hello"]
'hello'.partition('x') # => ["hello", "", ""]
'тест'.partition('т') # => ["", "т", "ест"]
'こんにちは'.partition('に') # => ["こん", "に", "ちは"]
Related: see {Converting to Non-String}[rdoc-ref:String@Converting+to+Non--5CString].
|
