Difference between revisions of "To boolean"

From Kolmafia
Jump to navigation Jump to search
imported>StDoodle
m
imported>Eliteofdelete
(Updated)
 
(17 intermediate revisions by 6 users not shown)
Line 5: Line 5:
 
FunctionPage|
 
FunctionPage|
 
name={{#var:name}}|
 
name={{#var:name}}|
function_category=Datatype Conversions|
 
  
 
function1={{Function|
 
function1={{Function|
Line 12: Line 11:
 
return_type={{#var:return_type}}|
 
return_type={{#var:return_type}}|
 
return_also={{#var:return_also}}|
 
return_also={{#var:return_also}}|
parameter1={{Param|any|anything}}|
+
parameter1={{Param|int|convert}}|
p1desc={{Pspan|anything}} is any data type that KoLmafia uses|
 
 
}}|
 
}}|
  
function_description=Converts stuff.
+
function2={{Function|
* strings do this
+
name={{#var:name}}|
* ints do that.|
+
aggregate={{#var:aggregate}}|
 +
return_type={{#var:return_type}}|
 +
return_also={{#var:return_also}}|
 +
parameter1={{Param|float|convert}}|
 +
}}|
  
needscode=yes|
+
function3={{Function|
 +
name={{#var:name}}|
 +
aggregate={{#var:aggregate}}|
 +
return_type={{#var:return_type}}|
 +
return_also={{#var:return_also}}|
 +
parameter1={{Param|string|convert}}|
 +
p1desc={{Pspan|convert}} is the int, float, or string to convert|
 +
}}|
  
see_also={{SeeAlso|}}|
+
function_description=Datatype behaviour:
cli_equiv=The CLI command |
+
This function converts the supplied datatype to a boolean value.  For strings, this means that it will return false for everything except "true". For all other datatypes, it returns to_int(anything) != 0.  More details:
more_info= |
+
 
special= |
+
* As indicated, integers return true for anything except 0, even negative values.
 +
* floats return true for anything except -1.0 to 1.0 (not inclusive).  This is because to_int(float) truncates the float.
 +
Note: The string is case insensitive.|
 +
 
 +
code1={{CodeSample|
 +
title=Code Samples|
 +
description=Following example shows basic to_boolean operations.|
 +
code=
 +
<syntaxhighlight>
 +
string first, second, third, fourth;
 +
int fifth, sixth;
 +
 
 +
first = "random stuff";
 +
second = "true";
 +
third = "tRuE";
 +
fourth = "TRUE";
 +
fifth = 5;
 +
sixth = 0;
 +
 
 +
print(first+" gives "+to_boolean(first)+".", "blue");
 +
print(second+" gives "+to_boolean(second)+".", "blue");
 +
print(third+" gives "+to_boolean(third)+".", "blue");
 +
print(fourth+" gives "+to_boolean(fourth)+".", "blue");
 +
print(fifth+" gives "+to_boolean(fifth)+".", "blue");
 +
print(sixth+" gives "+to_boolean(sixth)+".", "blue");
 +
 
 +
 
 +
</syntaxhighlight>|
 +
moreinfo=It gives the following output.
 +
<pre>
 +
random stuff gives false.
 +
true gives true.
 +
tRuE gives true.
 +
TRUE gives true.
 +
5 gives true.
 +
0 gives false.
 +
</pre>
 +
}}|
 +
 
 +
see_also={{SeeAlso|to_int}}
 
}}
 
}}
 +
 +
[[Category:Datatype Conversions]]

Latest revision as of 14:18, 26 January 2015

Function Syntax

boolean to_boolean(int convert )

boolean to_boolean(float convert )

boolean to_boolean(string convert )

  • convert is the int, float, or string to convert

Datatype behaviour: This function converts the supplied datatype to a boolean value. For strings, this means that it will return false for everything except "true". For all other datatypes, it returns to_int(anything) != 0. More details:

  • As indicated, integers return true for anything except 0, even negative values.
  • floats return true for anything except -1.0 to 1.0 (not inclusive). This is because to_int(float) truncates the float.

Note: The string is case insensitive.

Code Samples

Following example shows basic to_boolean operations.

string first, second, third, fourth;
int fifth, sixth;

first = "random stuff";
second = "true";
third = "tRuE";
fourth = "TRUE";
fifth = 5;
sixth = 0;

print(first+" gives "+to_boolean(first)+".", "blue");
print(second+" gives "+to_boolean(second)+".", "blue");
print(third+" gives "+to_boolean(third)+".", "blue");
print(fourth+" gives "+to_boolean(fourth)+".", "blue");
print(fifth+" gives "+to_boolean(fifth)+".", "blue");
print(sixth+" gives "+to_boolean(sixth)+".", "blue");

It gives the following output.

random stuff gives false.
true gives true.
tRuE gives true.
TRUE gives true.
5 gives true.
0 gives false.

See Also

to_int()