From: prodis@...
Date: 2015-12-19T17:06:21+00:00
Subject: [ruby-core:72390] [Ruby trunk - Bug #11848] [Open] New #to_b method for String, Symbol, Numeric, NilClass, TrueClass and FalseClass.

Issue #11848 has been reported by Fernando Hamasaki de Amorim.

----------------------------------------
Bug #11848: New #to_b method for String, Symbol, Numeric, NilClass, TrueClass and FalseClass.
https://bugs.ruby-lang.org/issues/11848

* Author: Fernando Hamasaki de Amorim
* Status: Open
* Priority: Normal
* Assignee: 
* ruby -v: 
* Backport: 2.0.0: UNKNOWN, 2.1: UNKNOWN, 2.2: UNKNOWN
----------------------------------------
New ***to_b*** method converts **strings**, **symbols**, **numbers** and **nil** values in a **boolean** value.

***to_b*** method is available on ***String***, ***Symbol***, ***Numeric***, ***TrueClass***, ***FalseClass*** and ***NilClass*** classes.

## String
Returns ***true*** if string is one of **t**, **true**, **on**, **y**, **yes** or **1** values. Returns ***false*** otherwise.
Ignores trailing spaces and letter cases.

~~~ruby
't'.to_b        # => true
'true'.to_b     # => true
'on'.to_b       # => true
'y'.to_b        # => true
'yes'.to_b      # => true
'1'.to_b        # => true

''.to_b         # => false
'0'.to_b        # => false
'2'.to_b        # => false
'-1'.to_b       # => false
'f'.to_b        # => false
'false'.to_b    # => false
'off'.to_b      # => false
'n'.to_b        # => false
'no'.to_b       # => false
'wherever'.to_b # => false
~~~

## Symbol
Same as ***symbol.to_s.to_b***.

~~~ruby
:'1'.to_b      # => true
:t.to_b        # => true
:true.to_b     # => true
:on.to_b       # => true
:y.to_b        # => true
:yes.to_b      # => true

:f.to_b        # => false
:false.to_b    # => false
:off.to_b      # => false
:n.to_b        # => false
:no.to_b       # => false
:wherever.to_b # => false
~~~

## Numeric
Returns ***false*** if number is **zero**. Returns ***true*** otherwise.

### Integer
~~~ruby
0.to_b  # => false
1.to_b  # => true
2.to_b  # => true
-1.to_b # => true
-2.to_b # => true
~~~

### Float
~~~ruby
0.0.to_b  # => false
0.1.to_b  # => true
1.0.to_b  # => true
-0.1.to_b # => true
-1.0.to_b # => true
~~~

### BigDecimal
~~~ruby
require 'bigdecimal'

BigDecimal('0.0').to_b  # => false
BigDecimal('0.1').to_b  # => true
BigDecimal('1.0').to_b  # => true
BigDecimal('-0.1').to_b # => true
BigDecimal('-1.0').to_b # => true
~~~

## NilClass
Returns ***false***.

~~~ruby
nil.to_b # => false
~~~

## TrueClass
Returns ***true***.

~~~ruby
true.to_b # => true
~~~

## FalseClass
Returns ***false***.

~~~ruby
false.to_b # => false
~~~


---Files--------------------------------
to_b_method.diff (9.63 KB)


-- 
https://bugs.ruby-lang.org/