検索結果

Range#begin -> object (18154.0)

• 2.1.0
• 2.2.0
• 2.3.0
• 2.4.0
• 2.5.0
• 2.6.0
• 2.7.0
• 3.0
• 3.1
• 3.2
• 3.3
• 3.4

• インスタンスメソッド

始端の要素を返します。 始端を持たない範囲オブジェクトの場合、begin はnilを返しますが, first は例外 RangeError が発生します。

...ェクトの場合、begin はnilを返しますが, first は例外 RangeError が発生します。

//emlist[例][ruby]{
# 始端を持つ場合
p (1..5).begin # => 1
p (1..0).begin # => 1
p (1..5).first # => 1
p (1..0).first # => 1

# 始端を持たない場合
p (..5).begin #=> nil
p (..5).fir...

• Range
• RangeError

MatchData#begin(n) -> Integer | nil (18152.0)

• 2.1.0
• 2.2.0
• 2.3.0
• 2.4.0
• 2.5.0
• 2.6.0
• 2.7.0
• 3.0
• 3.1
• 3.2
• 3.3
• 3.4

• インスタンスメソッド

n 番目の部分文字列先頭のオフセットを返します。

...範囲外の n を指定した場合に発生します。

//emlist[例][ruby]{
/(foo)(bar)(BAZ)?/ =~ "foobarbaz"
p $~.begin(0) # => 0
p $~.begin(1) # => 0
p $~.begin(2) # => 3
p $~.begin(3) # => nil
p $~.begin(4) # => `begin': index 4 out of matches (IndexError)
//}

@see MatchData#end...

• MatchData

MatchData#bytebegin(n) -> Integer | nil (6163.0)

• 3.4

• インスタンスメソッド

n 番目の部分文字列先頭のバイトオフセットを返します。

...します。

//emlist[例][ruby]{
/(c).*(いう).*(e.*)/ =~ 'abcあいうdef'
p $~ # => #<MatchData "cあいうdef" 1:"c" 2:"いう" 3:"ef">
p $~.bytebegin(0) # => 2
p $~.bytebegin(1) # => 2
p $~.bytebegin(2) # => 6
p $~.bytebegin(3) # => 13
p $~.bytebegin(4) # => index 4 out of matche...

...ror)
//}

//emlist[シンボルを指定する例][ruby]{
/(?<key>\S+):\s*(?<value>\S+)/ =~ "name: ruby"
$~ # => #<MatchData "name: ruby" key:"name" value:"ruby">
$~.bytebegin(:key) # => 0
$~.bytebegin(:value) # => 6
$~.bytebegin(:foo) # => undefined group name reference: foo (...

• MatchData

MatchData#bytebegin(name) -> Integer | nil (6163.0)

• 3.4

• インスタンスメソッド

n 番目の部分文字列先頭のバイトオフセットを返します。

...します。

//emlist[例][ruby]{
/(c).*(いう).*(e.*)/ =~ 'abcあいうdef'
p $~ # => #<MatchData "cあいうdef" 1:"c" 2:"いう" 3:"ef">
p $~.bytebegin(0) # => 2
p $~.bytebegin(1) # => 2
p $~.bytebegin(2) # => 6
p $~.bytebegin(3) # => 13
p $~.bytebegin(4) # => index 4 out of matche...

...ror)
//}

//emlist[シンボルを指定する例][ruby]{
/(?<key>\S+):\s*(?<value>\S+)/ =~ "name: ruby"
$~ # => #<MatchData "name: ruby" key:"name" value:"ruby">
$~.bytebegin(:key) # => 0
$~.bytebegin(:value) # => 6
$~.bytebegin(:foo) # => undefined group name reference: foo (...

• MatchData

Range#first -> object (3054.0)

• 2.1.0
• 2.2.0
• 2.3.0
• 2.4.0
• 2.5.0
• 2.6.0
• 2.7.0
• 3.0
• 3.1
• 3.2
• 3.3
• 3.4

• インスタンスメソッド

始端の要素を返します。 始端を持たない範囲オブジェクトの場合、begin はnilを返しますが, first は例外 RangeError が発生します。

...ェクトの場合、begin はnilを返しますが, first は例外 RangeError が発生します。

//emlist[例][ruby]{
# 始端を持つ場合
p (1..5).begin # => 1
p (1..0).begin # => 1
p (1..5).first # => 1
p (1..0).first # => 1

# 始端を持たない場合
p (..5).begin #=> nil
p (..5).fir...

• Range
• RangeError

絞り込み条件を変える

Range#first(n) -> [object] (3034.0)

• 2.1.0
• 2.2.0
• 2.3.0
• 2.4.0
• 2.5.0
• 2.6.0
• 2.7.0
• 3.0
• 3.1
• 3.2
• 3.3
• 3.4

• インスタンスメソッド

最初の n 要素を返します。範囲内に要素が含まれない場合は空の配列を返します。

...に整数以外の(暗黙の型変換が行えない)オブジェクトを
指定した場合に発生します。

@raise ArgumentError n に負の数を指定した場合に発生します。

//emlist[例][ruby]{
(10..20).first(3) # => [10, 11, 12]
//}

@see Range#last, 12697...

• Range

Array#[](range) -> Array | nil (79.0)

• 2.1.0
• 2.2.0
• 2.3.0
• 2.4.0
• 2.5.0
• 2.6.0
• 2.7.0
• 3.0
• 3.1
• 3.2
• 3.3
• 3.4

• インスタンスメソッド

Range オブジェクト range の範囲にある要素からなる部分配列を返します。 range の begin が自身の範囲外となる時は nil を返します。ただし、begin が配列の長さに等しいときは空の配列を返します。 range の begin が end より後にある場合には空の配列を返します。

...ある要素からなる部分配列を返します。
range の begin が自身の範囲外となる時は nil を返します。ただし、begin が配列の長さに等しいときは空の配列を返します。
range の begin が end より後にある場合には空の配列を返します...

...range の begin や end の値が負の時には末尾からのインデックスと見倣します。末尾
の要素が -1 番目になります。
end の値が配列の範囲を越える時には、越えた分は無視されます。

//emlist[例][ruby]{
a = [ "a"...

...から -2 番目、end は先頭から (4+1) 番目となる。)
a[0..10] #=> ["a", "b", "c", "d", "e"]
a[10..11] #=> nil
a[2..1] #=> []
a[-1..-2] #=> []

# 特殊なケース。begin が自身の長さと同じ場合には以下のようになります。
a[5] #=> nil
a[5..10] #=> []
//}...

• Array
• Range

Comparable#clamp(min, max) -> object (75.0)

• 3.0
• 3.1
• 3.2
• 3.3
• 3.4

• インスタンスメソッド

self を範囲内に収めます。

...ようになります。
self <=> range.begin が負数を返したときは range.begin を、
self <=> range.end が正数を返したときは range.end を、
それ以外の場合は self を返します。

range.begin が nil の場合、range.begin は self よりも小さい値として扱...

...いときに発生します。

//emlist[例][ruby]{
12.clamp(0, 100) #=> 12
523.clamp(0, 100) #=> 100
-3.123.clamp(0, 100) #=> 0

'd'.clamp('a', 'f') #=> 'd'
'z'.clamp('a', 'f') #=> 'f'
//}

//emlist[nil を渡す例][ruby]{
5.clamp(0, nil) #=> 5
5.clamp(nil, 0...

...mlist[range を渡す例][ruby]{
12.clamp(0..100) #=> 12
523.clamp(0..100) #=> 100
-3.123.clamp(0..100) #=> 0

'd'.clamp('a'..'f') #=> 'd'
'z'.clamp('a'..'f') #=> 'f'

100.clamp(0...100) # ArgumentError
//}

//emlist[range の始端か終端が nil の場合][ruby]{
-20.clamp(0..) #=> 0...

• Comparable

Comparable#clamp(range) -> object (75.0)

• 3.0
• 3.1
• 3.2
• 3.3
• 3.4

• インスタンスメソッド

self を範囲内に収めます。

...ようになります。
self <=> range.begin が負数を返したときは range.begin を、
self <=> range.end が正数を返したときは range.end を、
それ以外の場合は self を返します。

range.begin が nil の場合、range.begin は self よりも小さい値として扱...

...いときに発生します。

//emlist[例][ruby]{
12.clamp(0, 100) #=> 12
523.clamp(0, 100) #=> 100
-3.123.clamp(0, 100) #=> 0

'd'.clamp('a', 'f') #=> 'd'
'z'.clamp('a', 'f') #=> 'f'
//}

//emlist[nil を渡す例][ruby]{
5.clamp(0, nil) #=> 5
5.clamp(nil, 0...

...mlist[range を渡す例][ruby]{
12.clamp(0..100) #=> 12
523.clamp(0..100) #=> 100
-3.123.clamp(0..100) #=> 0

'd'.clamp('a'..'f') #=> 'd'
'z'.clamp('a'..'f') #=> 'f'

100.clamp(0...100) # ArgumentError
//}

//emlist[range の始端か終端が nil の場合][ruby]{
-20.clamp(0..) #=> 0...

• Comparable

Comparable#clamp(min, max) -> object (63.0)

• 2.7.0

• インスタンスメソッド

self を範囲内に収めます。

...ようになります。
self <=> range.begin が負数を返したときは range.begin を、
self <=> range.end が正数を返したときは range.end を、
それ以外の場合は self を返します。

range.begin が nil の場合、range.begin は self よりも小さい値として扱...

...いときに発生します。

//emlist[例][ruby]{
12.clamp(0, 100) #=> 12
523.clamp(0, 100) #=> 100
-3.123.clamp(0, 100) #=> 0

'd'.clamp('a', 'f') #=> 'd'
'z'.clamp('a', 'f') #=> 'f'
//}


//emlist[range を渡す例][ruby]{
12.clamp(0..100) #=> 12
523.clamp(0..1...

...00) #=> 100
-3.123.clamp(0..100) #=> 0

'd'.clamp('a'..'f') #=> 'd'
'z'.clamp('a'..'f') #=> 'f'

100.clamp(0...100) # ArgumentError
//}

//emlist[range の始端か終端が nil の場合][ruby]{
-20.clamp(0..) #=> 0
523.clamp(..100) #=> 100
//}...

• Comparable

絞り込み条件を変える

Comparable#clamp(range) -> object (63.0)

• 2.7.0

• インスタンスメソッド

self を範囲内に収めます。

...ようになります。
self <=> range.begin が負数を返したときは range.begin を、
self <=> range.end が正数を返したときは range.end を、
それ以外の場合は self を返します。

range.begin が nil の場合、range.begin は self よりも小さい値として扱...

...いときに発生します。

//emlist[例][ruby]{
12.clamp(0, 100) #=> 12
523.clamp(0, 100) #=> 100
-3.123.clamp(0, 100) #=> 0

'd'.clamp('a', 'f') #=> 'd'
'z'.clamp('a', 'f') #=> 'f'
//}


//emlist[range を渡す例][ruby]{
12.clamp(0..100) #=> 12
523.clamp(0..1...

...00) #=> 100
-3.123.clamp(0..100) #=> 0

'd'.clamp('a'..'f') #=> 'd'
'z'.clamp('a'..'f') #=> 'f'

100.clamp(0...100) # ArgumentError
//}

//emlist[range の始端か終端が nil の場合][ruby]{
-20.clamp(0..) #=> 0
523.clamp(..100) #=> 100
//}...

• Comparable

Range#cover?(obj) -> bool (55.0)

• 2.6.0
• 2.7.0
• 3.0
• 3.1
• 3.2
• 3.3
• 3.4

• インスタンスメソッド

obj が範囲内に含まれている時に true を返します。

...end?がfalseなら「begin <= obj <= end」を、
trueなら「begin <= obj < end」を意味します。

@param obj 比較対象のオブジェクトを指定します。

//emlist[数値は連続的に扱われているため、 include? / cover? が同じ結果を返す][ruby]{
(1.1..2.3).includ...

...(1.555) # => true
//}

//emlist[String の例][ruby]{
('b'..'d').include?('d') # => true
('b'..'d').include?('ba') # => false
('b'..'d').cover?('d') # => true
('b'..'d').cover?('ba') # => true
//}

//emlist[Date, DateTime の例][ruby]{
require 'date'
(Date.today - 365 .. Date.today...

• Range

Random#rand -> Float (51.0)

• 2.1.0
• 2.2.0
• 2.3.0
• 2.4.0
• 2.5.0
• 2.6.0
• 2.7.0
• 3.0
• 3.1
• 3.2
• 3.3
• 3.4

• インスタンスメソッド

一様な擬似乱数を発生させます。

...範囲から除かれます。
range.end - range.begin が整数を返す場合は range.begin + self.rand((range.end - range.begin) + e)
の値を返します(e は終端を含む場合は1、含まない場合は0です)。
range.end - range.begin が実数を返す場合も同様です。
この...

...ge 発生させる乱数値の範囲を Range オブジェクトで指定します。
range.end - range.begin は数値である必要があり、
range.begin + 数値 が適切な値を返す必要があります。

@raise Errno::EDOM rand(1..Float::INFINITY) などのよ...

...、引数に負の数値を与えた時や (1..0) のような値が存在しない範囲を渡した時などに発生します。

//emlist[例][ruby]{
# Kernel.#rand とほぼ同様の使い勝手
prng = Random.new(1234)
prng.rand # => 0.1915194503788923
srand(1234)
rand...

• Random
• Range
• Time

Random#rand(max) -> Integer | Float (51.0)

• 2.1.0
• 2.2.0
• 2.4.0
• 2.5.0
• 2.6.0
• 3.2
• 3.4

• インスタンスメソッド

一様な擬似乱数を発生させます。

...範囲から除かれます。
range.end - range.begin が整数を返す場合は range.begin + self.rand((range.end - range.begin) + e)
の値を返します(e は終端を含む場合は1、含まない場合は0です)。
range.end - range.begin が実数を返す場合も同様です。
この...

...ge 発生させる乱数値の範囲を Range オブジェクトで指定します。
range.end - range.begin は数値である必要があり、
range.begin + 数値 が適切な値を返す必要があります。

@raise Errno::EDOM rand(1..Float::INFINITY) などのよ...

...、引数に負の数値を与えた時や (1..0) のような値が存在しない範囲を渡した時などに発生します。

//emlist[例][ruby]{
# Kernel.#rand とほぼ同様の使い勝手
prng = Random.new(1234)
prng.rand # => 0.1915194503788923
srand(1234)
rand...

• Random
• Range
• Time