Standard library jcore

Introduction

tbd...

stdlib

The stdlib module offers basic functions, which can be usable anytime.

printLine(line: any)

A simple wrapper for the print function with a newline at the end.

stringFrom(list: list)

Converts a list of elements in its stringified form. Usually, one would use this to convert a list of characters into a string.

math

The math module offers functions for often used math functions.

max(n1: number, n2: number)

Returns the bigger number from two given numbers.

min(n1: number, n2: number)

Returns the smaller number from two given numbers.

absolute(n: number)

Returns absolute (positive) value of a given number representing its distance from zero.

power(base: number, exponent: number)

Returns the power of a base raised to an exponent using the efficient Binary Exponentiation (Square-and-Multiply) algorithm in O(log n) time.

root(x: number, n: number)

Returns the approximated n-th root of a radicand (x) using Newton's Method. Returns nil by

• zero root (n == 0)
• an even root of a negative number
• a division by zero

This algorithm uses floating-point numbers, which inherently cause small precision errors due to the binary representation of decimal fractions under IEEE 754 standard. If you check the results of this, you are advides to use an approximation.

squareroot(x: number)

Returns the square root (2nd root) of a non-negative number using the internal implementation of root(x: number, n: number).

fibonacci(n: number)

Returns the calculated fibonacci number using a simple loop approach, which is not optimized (yet).

isPrime(n: number)

Returns true if a given number is a prime number. Implements an optimized implementation using wheel factorization.

date

The date module offers functions for date manipulation. Please note that this module does not support handling timezones. For passing and processing dates, a date struct is offered, containing fields for year, month and day.

checkIfYearIsLeapYear(year: number)

Returns true, if the passed year is a leap year.

getDateFromElapsedSeconds(elapsedSeconds: number)

Accepts unix time seconds and calculates based on these a date struct containing the corresponding day in time. The function supports negative unix time seconds for handling date before the 01.01.1970.

getElapsedSecondsFromDate(date: Date)

Accepts a date struct and calculates based on this a number of seconds since unix time. If the passed date if before unix time, the number of elapsed seconds will be negative.

stringFrom(date: Date)

A simple function for pretty printing a date struct.

print(date: Date)

Override the print function for pretty printing dates.

printLine(date: Date)

Override the printLine function for pretty printing dates with a newline.