Module:Utils/doc: Difference between revisions

Line 3:

This module provides several mathematical functions which are likely to be used frequently on the Xenharmonic Wiki.

Namely, the functions in this module can be called from other modules by using <code>require("Module:Utils")</code> and calling the ~~<code>_</code>~~-prefixed functions.

Namely, the functions in this module can be called from other modules by using <code>require("Module:Utils")</code> and calling the underscore-prefixed functions.

=== Functions ===

; <code>table_contains(tbl, x)</code>

; <code>table_contains(tbl, x)</code>*

: Check if table contains x~~. This function is designed to be used by other modules only; it cannot be called with <code>{{<nowiki />#invoke:}}</code>~~.

: Check if table contains x.

; <code>index_of(array, index)</code>

; <code>index_of(array, index)</code>*

: Return the first index with the given value (or nil if not found)~~. This function is designed to be used by other modules only; it cannot be called with <code>{{<nowiki />#invoke:}}</code>~~.

: Return the first index with the given value (or nil if not found).

; <code>value_provided(s)</code>

; <code>value_provided(s)</code>*

: Checks if <code>s</code> is a non-empty string~~. This function is designed to be used by other modules only; it cannot be called with <code>{{<nowiki />#invoke:}}</code>~~.

: Checks if <code>s</code> is a non-empty string.

; <code>eval_num_arg(input, def_value)</code>

; <code>eval_num_arg(input, def_value)</code>*

: Checks if <code>input</code> is a number; on error, use <code>def_value~~</code>. This function is designed to be used by other modules only; it cannot be called with <code>{{<nowiki />#invoke:}}~~</code>.

: Checks if <code>input</code> is a number; on error, use <code>def_value</code>.

; <code>log(x, b)</code>

Line 30:

: Returns <code>x</code> rounded to a precision of <code>prec</code> significant figures. Parameter <code>prec</code> defaults to 6 if it is omitted.

; <code>is_prime(n)</code>

; <code>is_prime(n)</code>*

: Returns <code>true</code> if the given integer <code>n</code> is a prime number~~. This function is designed to be used by other modules only; it cannot be called with <code>{{<nowiki />#invoke:}}</code>~~.

: Returns <code>true</code> if the given integer <code>n</code> is a prime number.

; <code>prime_factorization(n)</code>

: Returns the prime factorization of the given integer <code>n</code> using the exponential form (in wikitext).

; <code>prime_factorization_raw(n)</code>

; <code>prime_factorization_raw(n)</code>*

: Returns a table encoding the prime factorization of <code>n~~</code>. This function is designed to be used by other modules only; it cannot be called with <code>{{<nowiki />#invoke:}}~~</code>.

: Returns a table encoding the prime factorization of <code>n</code>.

; <code>signum(x)</code>

; <code>signum(x)</code>*

: Returns 1 for positive numbers, -1 for negative ones, 0 for zero and non-integer inputs~~. This function is designed to be used by other modules only; it cannot be called with <code>{{<nowiki />#invoke:}}</code>~~.

: Returns 1 for positive numbers, −1 for negative ones, and 0 for zero and non-integer inputs.

; <code>next_young_diagram(d)</code>

: Returns the next Young diagram of the same size; the first one is <code>[N]</code>, the last one is <code>[1, 1, ..., 1]</code>. After the last one, <code>nil</code> is returned. The input table is modified. ~~This function is~~ designed to be used by other modules only; it cannot be called with <code>{{<nowiki />#invoke:}}</code>.

: Returns the next Young diagram of the same size; the first one is <code>[N]</code>, the last one is <code>[1, 1, ..., 1]</code>. After the last one, <code>nil</code> is returned. The input table is modified.<br /><br />

<nowiki />* These functions are designed to be used by other modules only; they cannot be called with <code>{{<nowiki />#invoke:}}</code>.

}}

@@ Line 3: / Line 3: @@
 This module provides several mathematical functions which are likely to be used frequently on the Xenharmonic Wiki.
-Namely, the functions in this module can be called from other modules by using <code>require("Module:Utils")</code> and calling the <code>_</code>-prefixed functions.
+Namely, the functions in this module can be called from other modules by using <code>require("Module:Utils")</code> and calling the underscore-prefixed functions.
 === Functions ===
-; <code>table_contains(tbl, x)</code>
+; <code>table_contains(tbl, x)</code>*
-: Check if table contains x. This function is designed to be used by other modules only; it cannot be called with <code>{{<nowiki />#invoke:}}</code>.
+: Check if table contains x.
-; <code>index_of(array, index)</code>
+; <code>index_of(array, index)</code>*
-: Return the first index with the given value (or nil if not found). This function is designed to be used by other modules only; it cannot be called with <code>{{<nowiki />#invoke:}}</code>.
+: Return the first index with the given value (or nil if not found).
-; <code>value_provided(s)</code>
+; <code>value_provided(s)</code>*
-: Checks if <code>s</code> is a non-empty string. This function is designed to be used by other modules only; it cannot be called with <code>{{<nowiki />#invoke:}}</code>.
+: Checks if <code>s</code> is a non-empty string.
-; <code>eval_num_arg(input, def_value)</code>
+; <code>eval_num_arg(input, def_value)</code>*
-: Checks if <code>input</code> is a number; on error, use <code>def_value</code>. This function is designed to be used by other modules only; it cannot be called with <code>{{<nowiki />#invoke:}}</code>.
+: Checks if <code>input</code> is a number; on error, use <code>def_value</code>.
 ; <code>log(x, b)</code>
@@ Line 30: / Line 30: @@
 : Returns <code>x</code> rounded to a precision of <code>prec</code> significant figures. Parameter <code>prec</code> defaults to 6 if it is omitted.
-; <code>is_prime(n)</code>
+; <code>is_prime(n)</code>*
-: Returns <code>true</code> if the given integer <code>n</code> is a prime number. This function is designed to be used by other modules only; it cannot be called with <code>{{<nowiki />#invoke:}}</code>.
+: Returns <code>true</code> if the given integer <code>n</code> is a prime number.
 ; <code>prime_factorization(n)</code>
 : Returns the prime factorization of the given integer <code>n</code> using the exponential form (in wikitext).
-; <code>prime_factorization_raw(n)</code>
+; <code>prime_factorization_raw(n)</code>*
-: Returns a table encoding the prime factorization of <code>n</code>. This function is designed to be used by other modules only; it cannot be called with <code>{{<nowiki />#invoke:}}</code>.
+: Returns a table encoding the prime factorization of <code>n</code>.
-; <code>signum(x)</code>
+; <code>signum(x)</code>*
-: Returns 1 for positive numbers, -1 for negative ones, 0 for zero and non-integer inputs. This function is designed to be used by other modules only; it cannot be called with <code>{{<nowiki />#invoke:}}</code>.
+: Returns 1 for positive numbers, −1 for negative ones, and 0 for zero and non-integer inputs.
 ; <code>next_young_diagram(d)</code>
-: Returns the next Young diagram of the same size; the first one is <code>[N]</code>, the last one is <code>[1, 1, ..., 1]</code>. After the last one, <code>nil</code> is returned. The input table is modified. This function is designed to be used by other modules only; it cannot be called with <code>{{<nowiki />#invoke:}}</code>.
+: Returns the next Young diagram of the same size; the first one is <code>[N]</code>, the last one is <code>[1, 1, ..., 1]</code>. After the last one, <code>nil</code> is returned. The input table is modified.<br /><br />
+<nowiki />* These functions are designed to be used by other modules only; they cannot be called with <code>{{<nowiki />#invoke:}}</code>.
 }}