Data Types - Revision history

HippoKing: /* Special Datatypes */ add modifier type

2025-03-16T00:39:41Z

Special Datatypes: add modifier type

← Older revision		Revision as of 00:39, 16 March 2025
Line 185:		Line 185:

	The full range, besides $location[ none ], is too much to list and keep up with here: please see the Wiki {{kolwiki\|Locations}} page for more information.		The full range, besides $location[ none ], is too much to list and keep up with here: please see the Wiki {{kolwiki\|Locations}} page for more information.

			===modifier===

			([[Modifier#Related Functions\|Related Functions]]) ([[Modifier#Proxy Record Fields\|Proxy Record Fields]])

			Modifiers control properties of your character and your skills, items etc. For example you want to know your item drop bonus, that's <syntaxhighlight enclose="none">$modifier[item drop]</syntaxhighlight>.

			The full range, besides <syntaxhighlight enclose="none">$modifier[ none ]</syntaxhighlight>, is too much to list and keep up with here: please see the [[modifiers]] page for more information.

	===monster===		===monster===

Mcroft: /* float */

2023-03-02T03:15:45Z

float

← Older revision		Revision as of 03:15, 2 March 2023
Line 25:		Line 25:
	===float===		===float===

	The float data type is a double-precision 64-bit IEEE 754 floating point. Its range of values is beyond the scope of this discussion, but is specified in [~~http~~://~~java~~.~~sun~~.com/~~docs~~/~~books~~/jls/~~third_edition~~/html/~~typesValues~~.html#4.2.3 section 4.2.3 of the Java Language Specification], and a tool to help understand / quickly see how/where imprecisions happen can be found [https://www.h-schmidt.net/FloatConverter/IEEE754.html here].		The float data type is a double-precision 64-bit IEEE 754 floating point. Its range of values is beyond the scope of this discussion, but is specified in [hhttps://docs.oracle.com/javase/specs/jls/se17/html/jls-4.html#jls-4.2.3 section 4.2.3 of the Java Language Specification], and a tool to help understand / quickly see how/where imprecisions happen can be found [https://www.h-schmidt.net/FloatConverter/IEEE754.html here].

	When assigning to a variable of type float, one should be careful to always enter numbers in decimal form, as unwanted behavior can result from supplying a value that KoLmafia may interpret as an int type without the decimal point.		When assigning to a variable of type float, one should be careful to always enter numbers in decimal form, as unwanted behavior can result from supplying a value that KoLmafia may interpret as an int type without the decimal point.

Mcroft: size of int pool...

2023-03-02T03:13:23Z

size of int pool...

← Older revision		Revision as of 03:13, 2 March 2023
Line 365:		Line 365:

	The remaining types that can be used in plural constants require an explicit list of elements, since there are too many possible values:		The remaining types that can be used in plural constants require an explicit list of elements, since there are too many possible values:
	* $ints[] - you don't have enough RAM to store a list with ~~4 billion~~ elements.		* $ints[] - you don't have enough RAM to store a list with 18 sextillion elements.
	* $floats[] - ditto.		* $floats[] - ditto.
	* $strings[] - nobody has that much RAM.		* $strings[] - nobody has that much RAM.

Mcroft: /* float */

2023-03-02T03:08:27Z

float

← Older revision		Revision as of 03:08, 2 March 2023
Line 25:		Line 25:
	===float===		===float===

	The float data type is a ~~single~~-precision 32-bit IEEE 754 floating point. Its range of values is beyond the scope of this discussion, but is specified in [http://java.sun.com/docs/books/jls/third_edition/html/typesValues.html#4.2.3 section 4.2.3 of the Java Language Specification], and a tool to help understand / quickly see how/where imprecisions happen can be found [https://www.h-schmidt.net/FloatConverter/IEEE754.html here].		The float data type is a double-precision 64-bit IEEE 754 floating point. Its range of values is beyond the scope of this discussion, but is specified in [http://java.sun.com/docs/books/jls/third_edition/html/typesValues.html#4.2.3 section 4.2.3 of the Java Language Specification], and a tool to help understand / quickly see how/where imprecisions happen can be found [https://www.h-schmidt.net/FloatConverter/IEEE754.html here].

	When assigning to a variable of type float, one should be careful to always enter numbers in decimal form, as unwanted behavior can result from supplying a value that KoLmafia may interpret as an int type without the decimal point.		When assigning to a variable of type float, one should be careful to always enter numbers in decimal form, as unwanted behavior can result from supplying a value that KoLmafia may interpret as an int type without the decimal point.

Mcroft: /* int */ is 64 bit

2023-03-02T03:07:06Z

int: is 64 bit

← Older revision		Revision as of 03:07, 2 March 2023
Line 10:		Line 10:
	===int===		===int===

	A whole number (short for "integer"), either positive or negative (or 0). The int used by KoLmafia is a 32-bit signed int, meaning it has a maximum value of 2,~~147~~,~~483~~,~~647~~ and a minimum value of -2,~~147~~,~~483~~,~~648~~. The default value of a integer variable is 0.		A whole number (short for "integer"), either positive or negative (or 0). The int used by KoLmafia is a 64-bit signed int, meaning it has a maximum value of 9,223,372,036,854,775,807 and a minimum value of -9,223,372,036,854,775,808. The default value of a integer variable is 0.

	Be careful when doing math with integers! As with some other strongly-typed languages, numbers are converted to integers at every step of the operation when only integer types are used. For example:		Be careful when doing math with integers! As with some other strongly-typed languages, numbers are converted to integers at every step of the operation when only integer types are used. For example:

QuietMisdreavus: /* path */

2022-10-02T19:31:48Z

path

← Older revision		Revision as of 19:31, 2 October 2022
Line 199:		Line 199:

	Any ascension path you can choose in Valhalla is valid for this datatype. This includes all {{kolwiki\|special challenge paths}}, as well as Standard and the dietary restriction paths (Boozetafarian, Teetotaler, Oxygenarian). The "Unrestricted" path and aftercore are represented as $path[ none ].		Any ascension path you can choose in Valhalla is valid for this datatype. This includes all {{kolwiki\|special challenge paths}}, as well as Standard and the dietary restriction paths (Boozetafarian, Teetotaler, Oxygenarian). The "Unrestricted" path and aftercore are represented as $path[ none ].

			The full range, besides $path[ none ], is too much to list and keep up with here. See {{kolwiki\|Ascension#Paths}} for more information.

	===phylum===		===phylum===

QuietMisdreavus at 19:28, 2 October 2022

2022-10-02T19:28:41Z

← Older revision		Revision as of 19:28, 2 October 2022
Line 193:		Line 193:

	The full range, besides $monster[ none ], is too much to list and keep up with here: please see the Wiki {{kolwiki\|Monster Compendium}} page for more information.		The full range, besides $monster[ none ], is too much to list and keep up with here: please see the Wiki {{kolwiki\|Monster Compendium}} page for more information.

			===path===

			([[Path#Related Functions\|Related Functions]]) ([[Path#Proxy Record Fields\|Proxy Record Fields]])

			Any ascension path you can choose in Valhalla is valid for this datatype. This includes all {{kolwiki\|special challenge paths}}, as well as Standard and the dietary restriction paths (Boozetafarian, Teetotaler, Oxygenarian). The "Unrestricted" path and aftercore are represented as $path[ none ].

	===phylum===		===phylum===

Fredg1: mutability

2020-11-05T00:07:53Z

mutability

← Older revision		Revision as of 00:07, 5 November 2020
Line 366:		Line 366:

	A matcher isn't really a datatype so much as it's a class, but it is included here for reference, as it is used much as datatypes are in ASH. It can only be declared through the function {{f\|create_matcher}}, using two strings. One is the string to find matches in, the other a regular expression to test against. For more information on using a matcher, see [[Regular Expressions]].		A matcher isn't really a datatype so much as it's a class, but it is included here for reference, as it is used much as datatypes are in ASH. It can only be declared through the function {{f\|create_matcher}}, using two strings. One is the string to find matches in, the other a regular expression to test against. For more information on using a matcher, see [[Regular Expressions]].

			==Notes==

			Buffers, aggregates, records and matchers are [https://developer.mozilla.org/en-US/docs/Glossary/Mutable mutable]. All other datatypes are immutable.

	[[Category:Scripting]]		[[Category:Scripting]]

Gausie: /* string */ Added template strings

2020-03-23T17:52:56Z

string: Added template strings

← Older revision		Revision as of 17:52, 23 March 2020
Line 43:		Line 43:
	===string===		===string===

	A group of characters including, but not limited to: lowercase letters, uppercase characters, numbers, and various control characters. When assigning a value to a string, ~~always~~ enclose the desired value in either single or double quotes (note you must use the same quote type on both ends of the string assignment). If you need to include the same character inside of the string itself, you will need to escape it first with a backslash.{{CodeSample\|		A group of characters including, but not limited to: lowercase letters, uppercase characters, numbers, and various control characters. When assigning a value to a string, enclose the desired value in either single quotes (<code>'</code>), double quotes (<code>"</code>) or backticks (<code>`</code>) (note you must use the same quote type on both ends of the string assignment). If you need to include the same character inside of the string itself, you will need to escape it first with a backslash.
	description=For example:\|
	code=		{{
	<syntaxhighlight>		CodeSample
	string s = "This is my \"friend\" Pete.";		\|description=For example:
	</syntaxhighlight>\|		\|code=<syntaxhighlight>string s = "This is my \"friend\" Pete.";</syntaxhighlight>
	moreinfo=		\|moreinfo=Will result in the following being stored to s:<pre>This is my "friend" Pete</pre>
	Will result in the following being stored to s:		}}
	<pre>This is my "friend" Pete</pre>}}
	The default value of a string is an empty string, or literally <code>""</code>.		The default value of a string is an empty string, or literally <code>""</code>

			When using backticks, you can concatenate expressions into your string using curly braces.

			{{
			CodeSample
			\|description=For example:
			\|code=<syntaxhighlight>string s = `Hello {my_name()}, you have {$item[lime].item_amount()} lime(s)!`;</syntaxhighlight>
			}}

	===buffer===		===buffer===

Fredg1: /* float */

2020-03-17T22:21:44Z

float

← Older revision		Revision as of 22:21, 17 March 2020
Line 25:		Line 25:
	===float===		===float===

	The float data type is a single-precision 32-bit IEEE 754 floating point. Its range of values is beyond the scope of this discussion, but is specified in ~~section 4.2.3 of the Java Language Specification.~~ [http://java.sun.com/docs/books/jls/third_edition/html/typesValues.html#4.2.3]		The float data type is a single-precision 32-bit IEEE 754 floating point. Its range of values is beyond the scope of this discussion, but is specified in [http://java.sun.com/docs/books/jls/third_edition/html/typesValues.html#4.2.3 section 4.2.3 of the Java Language Specification], and a tool to help understand / quickly see how/where imprecisions happen can be found [https://www.h-schmidt.net/FloatConverter/IEEE754.html here].

	When assigning to a variable of type float, one should be careful to always enter numbers in decimal form, as unwanted behavior can result from supplying a value that KoLmafia may interpret as an int type without the decimal point.		When assigning to a variable of type float, one should be careful to always enter numbers in decimal form, as unwanted behavior can result from supplying a value that KoLmafia may interpret as an int type without the decimal point.