ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: opt / alt / ruby34 / share / ri / system / Range

U:RDoc::AnyMethod[iI"cover?:ETI"Range#cover?;TF:publico:RDoc::Markup::Document:@parts[+o:RDoc::Markup::Paragraph;	[I"NReturns +true+ if the given argument is within +self+, +false+ otherwise.;To:RDoc::Markup::BlankLine�o;
;	[I"QWith non-range argument +object+, evaluates with <tt><=</tt> and <tt><</tt>.;T@o;
;	[I"QFor range +self+ with included end value (<tt>#exclude_end? == false</tt>), ;TI"evaluates thus:;T@o:RDoc::Markup::Verbatim;	[I"&self.begin <= object <= self.end
;T:@format0o;
;	[I"Examples:;T@o;;	[I"r = (1..4)
;TI"r.cover?(1)     # => true
;TI"r.cover?(4)     # => true
;TI" r.cover?(0)     # => false
;TI" r.cover?(5)     # => false
;TI" r.cover?('foo') # => false
;TI"
;TI"r = ('a'..'d')
;TI"!r.cover?('a')     # => true
;TI"!r.cover?('d')     # => true
;TI""r.cover?(' ')     # => false
;TI""r.cover?('e')     # => false
;TI""r.cover?(0)       # => false
;T;
0o;
;	[I"MFor range +r+ with excluded end value (<tt>#exclude_end? == true</tt>), ;TI"evaluates thus:;T@o;;	[I"r.begin <= object < r.end
;T;
0o;
;	[I"Examples:;T@o;;	[I"r = (1...4)
;TI"r.cover?(1)     # => true
;TI"r.cover?(3)     # => true
;TI" r.cover?(0)     # => false
;TI" r.cover?(4)     # => false
;TI" r.cover?('foo') # => false
;TI"
;TI"r = ('a'...'d')
;TI"!r.cover?('a')     # => true
;TI"!r.cover?('c')     # => true
;TI""r.cover?(' ')     # => false
;TI""r.cover?('d')     # => false
;TI""r.cover?(0)       # => false
;T;
0o;
;	[I">With range argument +range+, compares the first and last ;TI"$elements of +self+ and +range+:;T@o;;	[I"r = (1..4)
;TI""r.cover?(1..4)     # => true
;TI"#r.cover?(0..4)     # => false
;TI"#r.cover?(1..5)     # => false
;TI"#r.cover?('a'..'d') # => false
;TI"
;TI"r = (1...4)
;TI""r.cover?(1..3)     # => true
;TI"#r.cover?(1..4)     # => false
;T;
0o;
;	[I"AIf begin and end are numeric, #cover? behaves like #include?;T@o;;	[I""(1..3).cover?(1.5) # => true
;TI"$(1..3).include?(1.5) # => true
;T;
0o;
;	[I"6But when not numeric, the two methods may differ:;T@o;;	[I")('a'..'d').cover?('cc')   # => true
;TI"*('a'..'d').include?('cc') # => false
;T;
0o;
;	[I"Returns +false+ if either:;T@o:RDoc::Markup::List:
@type:BULLET:@items[o:RDoc::Markup::ListItem:@label0;	[o;
;	[I"<The begin value of +self+ is larger than its end value.;To;;0;	[o;
;	[I"6An internal call to <tt>#<=></tt> returns +nil+; ;TI".that is, the operands are not comparable.;T@o;
;	[	I"HBeginless ranges cover all values of the same type before the end, ;TI"Dexcluding the end for exclusive ranges. Beginless ranges cover ;TI"Franges that end before the end of the beginless range, or at the ;TI"5end of the beginless range for inclusive ranges.;T@o;;	[I"#(..2).cover?(1)     # => true
;TI"#(..2).cover?(2)     # => true
;TI"$(..2).cover?(3)     # => false
;TI"$(...2).cover?(2)    # => false
;TI"$(..2).cover?("2")   # => false
;TI"#(..2).cover?(..2)   # => true
;TI"#(..2).cover?(...2)  # => true
;TI"$(..2).cover?(.."2") # => false
;TI"$(...2).cover?(..2)  # => false
;T;
0o;
;	[I"@Endless ranges cover all values of the same type after the ;TI">beginning. Endless exclusive ranges do not cover endless ;TI"inclusive ranges.;T@o;;	[I"$(2..).cover?(1)     # => false
;TI"#(2..).cover?(3)     # => true
;TI"#(2...).cover?(3)    # => true
;TI"#(2..).cover?(2)     # => true
;TI"$(2..).cover?("2")   # => false
;TI"#(2..).cover?(2..)   # => true
;TI"#(2..).cover?(2...)  # => true
;TI"$(2..).cover?("2"..) # => false
;TI"$(2...).cover?(2..)  # => false
;TI"#(2...).cover?(3...) # => true
;TI"$(2...).cover?(3..)  # => false
;TI"$(3..).cover?(2..)   # => false
;T;
0o;
;	[	I"ERanges that are both beginless and endless cover all values and ;TI"Hranges, and return true for all arguments, with the exception that ;TI"Abeginless and endless exclusive ranges do not cover endless ;TI"inclusive ranges.;T@o;;	[
I"+(nil...).cover?(Object.new) # => true
;TI"+(nil...).cover?(nil...)     # => true
;TI"+(nil..).cover?(nil...)      # => true
;TI",(nil...).cover?(nil..)      # => false
;TI",(nil...).cover?(1..)        # => false
;T;
0o;
;	[I"Related: Range#include?.;T:
@fileI"range.c;T:0@omit_headings_from_table_of_contents_below0I"Dcover?(object) -> true or false
cover?(range) -> true or false
;T0[�I"	(p1);T@�FI"
Range;TcRDoc::NormalClass00

[-] last-i.ri [edit]
[-] include%3f-i.ri [edit]
[-] count-i.ri [edit]
[-] size-i.ri [edit]
[-] bsearch-i.ri [edit]
[-] end-i.ri [edit]
[-] to_s-i.ri [edit]
[-] max-i.ri [edit]
[-] to_json-i.ri [edit]
[-] first-i.ri [edit]
[-] as_json-i.ri [edit]
[-] reverse_each-i.ri [edit]
[-] cover%3f-i.ri [edit]
[-] to_a-i.ri [edit]
[-] new-c.ri [edit]
[-] minmax-i.ri [edit]
[-] json_create-c.ri [edit]
[-] min-i.ri [edit]
[-] hash-i.ri [edit]
[-] each-i.ri [edit]
[-] step-i.ri [edit]
[-] %3d%3d%3d-i.ri [edit]
[-] eql%3f-i.ri [edit]
[-] cdesc-Range.ri [edit]
[-] member%3f-i.ri [edit]
[-] %25-i.ri [edit]
[-] exclude_end%3f-i.ri [edit]
[-] begin-i.ri [edit]
[-] overlap%3f-i.ri [edit]
[+] ..
[-] entries-i.ri [edit]
[-] %3d%3d-i.ri [edit]
[-] inspect-i.ri [edit]