Differences

This shows you the differences between two versions of the page.

--- fuss:lolcode [2015/02/09 19:22] – office
+++ fuss:lolcode [2022/04/19 08:28] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
+====== About ======
+The API is compatible with the LOLCODE Specification 1.2. The functions have to be used between the opening and closing program blocks. For example:
+<code>
+HAI 1.2
+[... insert function ...]
+  I HAS A VAR ITZ 4
+  VISIBLE SMOOSH "Factorial: " AN I IZ WAS_FAK YR VAR MKAY
+KTHXBYE
+</code>
+will print out the factorial of ''4'' provided that the ''WAS_FAK'' function is inserted into the placeholder (this is because functions in LOLCODE cannot live outside of the ''HAI''/''KTHXBYE'' code-blocks.
+====== Numerical Inequalities ======
+A set of functions that perform various numerical inequalities following LaTeX syntax: ''LT'' ($<$), ''LE'' ($\le$), ''GT'' ($>$) and ''GE'' ($\ge$).
+===== Less Than ========
+<code lolcode>
+OBTW  Copyright (C) 2014 Wizardry and Steamworks - License: GNU GPLv3  TLDR
+HOW IZ I LT YR LEFT AN YR RIGHT
+    FOUND YR DIFFRINT LEFT AN BIGGR OF LEFT AN RIGHT
+IF U SAY SO
+</code>
+===== Greater Than =====
+<code lolcode>
+OBTW  Copyright (C) 2014 Wizardry and Steamworks - License: GNU GPLv3  TLDR
+HOW IZ I GT YR LEFT AN YR RIGHT
+    FOUND YR DIFFRINT LEFT AN SMALLR OF LEFT AN RIGHT
+IF U SAY SO
+</code>
+===== Less or Equal Than =====
+<code lolcode>
+OBTW  Copyright (C) 2014 Wizardry and Steamworks - License: GNU GPLv3  TLDR
+HOW IZ I LE YR LEFT AN YR RIGHT
+    BOTH SAEM LEFT AN SMALLR OF LEFT AN RIGHT
+IF U SAY SO
+</code>
+===== Greater or Equal Than =====
+<code lolcode>
+OBTW  Copyright (C) 2014 Wizardry and Steamworks - License: GNU GPLv3  TLDR
+HOW IZ I GE YR LEFT AN YR RIGHT
+    FOUND YR BOTH SAEM LEFT AN BIGGR OF LEFT AN RIGHT
+IF U SAY SO
+</code>
+====== Raise Base to Exponent ======
+<code lolcode>
+OBTW  Copyright (C) 2014 Wizardry and Steamworks - License: GNU GPLv3  TLDR
+HOW IZ I WAS_RAIZ YR FOOT AN YR PAW
+  I HAS A BASE ITZ FOOT
+  IM IN YR LOOP UPPIN YR STUFF WILE DIFFRINT STUFF AN PAW
+    FOOT R PRODUKT OF FOOT AN BASE
+  IM OUTTA YR LOOP
+  FOUND YR QUOSHUNT OF FOOT AN BASE
+IF U SAY SO
+</code>
+====== Factorial ======
+<code lolcode>
+OBTW  Copyright (C) 2014 Wizardry and Steamworks - License: GNU GPLv3  TLDR
+HOW IZ I WAS_FAK YR TAIL
+    TAIL, WTF?
+        OMG 0
+          FOUND YR 1
+        OMG 1
+          FOUND YR TAIL
+    OIC
+    FOUND YR PRODUKT OF TAIL AN I IZ WAS_FAK YR DIFF OF TAIL AN 1 MKAY
+IF U SAY SO
+</code>
+====== Random Number Generator ======
+This is a Lehmer random number generator,
+$$
+X_{k+1} = g*X_{k} \mod{n}
+$$
+using the ZX Spectrum Fermat prime vectors where $g=75$ and $n=65537$.
+<code lolcode>
+OBTW  Copyright (C) 2014 Wizardry and Steamworks - License: GNU GPLv3  TLDR
+I HAS A COUNTER ITZ 1
+HOW IZ I WAS_MESS YR NUMBER
+    I HAS A THING ITZ MAEK NUMBER A NUMBAR
+    IM IN YR LOOP UPPIN YR ROUNDS WILE DIFFRINT ROUNDS AN NUMBER
+        THING R MOD OF PRODUKT OF 75 AN SUM OF THING AN COUNTER AN 65537
+        COUNTER R SUM OF COUNTER AN 1
+    IM OUTTA YR LOOP
+    FOUND YR MOD OF THING AN NUMBER
+IF U SAY SO
+</code>
+The algorithm will generate numbers in the interval $[0,65537)$ (larger if a different Fermat prime is chosen for $g$). The function takes a parameter an upper bound ''NUMBER'' and can be called using:
+<code lolcode>
+VISIBLE I IZ WAS_MESS YR 100 MKAY
+</code>
+which will generate a random number in the interval $[0, 100)$.
+The following plot:
+<plot>
+set terminal png size 900,256
+set xlabel "Draw"
+set ylabel "Value"
+plot "-" using ($1*5):2 with lines title ""
+	94
+	2
+	10
+	55
+	63
+	71
+	79
+	24
+	32
+	40
+	48
+	56
+	1
+	9
+	17
+	25
+	33
+	78
+	86
+	94
+	2
+	47
+	55
+	63
+	71
+	79
+	24
+	32
+	40
+	48
+	93
+	1
+	9
+	17
+	25
+	70
+	78
+	86
+	94
+	2
+	47
+	55
+	63
+	71
+	16
+	24
+	32
+	40
+	48
+	93
+	1
+	9
+	17
+	25
+	70
+	78
+	86
+	94
+	39
+	47
+	55
+	63
+	71
+	16
+	24
+	32
+	40
+	85
+	93
+	1
+	9
+	17
+	62
+	70
+	78
+	86
+	94
+	39
+	47
+	55
+	63
+	8
+	16
+	24
+	32
+	40
+	85
+	93
+	1
+	9
+	17
+	62
+	70
+	78
+	86
+	31
+	39
+	47
+	55
+	63
+	8
+	16
+	24
+	32
+	77
+	85
+	93
+	1
+	9
+	54
+	62
+	70
+	78
+	86
+	31
+	39
+	47
+	55
+	0
+	8
+	16
+	24
+	32
+	77
+	85
+	93
+	1
+	46
+	54
+	62
+	70
+	78
+	23
+	31
+	39
+	47
+	55
+	0
+	8
+	16
+	24
+	69
+	77
+	85
+	93
+	1
+	46
+	54
+	62
+	70
+	78
+	23
+	31
+	39
+	47
+	92
+	0
+	8
+	16
+	24
+	69
+	77
+	85
+	93
+	38
+	46
+	54
+	62
+	70
+	15
+	23
+	31
+	39
+	47
+	92
+	0
+	8
+	16
+	61
+	69
+	77
+	85
+	93
+	38
+	46
+	54
+	62
+	7
+	15
+	23
+	31
+	39
+	84
+	92
+	0
+	8
+	16
+	61
+	69
+	77
+	85
+	30
+	38
+	46
+	54
+	62
+	7
+	15
+	23
+	31
+	39
+	84
+	92
+	0
+	8
+	53
+	61
+	69
+	77
+	85
+	30
+	38
+	46
+	54
+	99
+	7
+	15
+	23
+	31
+	76
+	84
+	92
+	0
+	8
+	53
+	61
+	69
+	77
+	22
+	30
+	38
+	46
+	54
+	99
+	7
+	15
+	23
+	31
+	76
+	84
+	92
+	0
+	45
+	53
+	61
+	69
+	77
+	22
+	30
+	38
+	46
+	91
+	99
+	7
+	15
+	23
+	68
+	76
+	84
+	92
+	0
+	45
+	53
+	61
+	69
+	14
+	22
+	30
+	38
+	46
+	91
+	99
+	7
+	15
+	60
+	68
+	76
+	84
+	92
+	37
+	45
+	53
+	61
+	69
+	14
+	22
+	30
+	38
+	83
+	91
+	99
+	7
+	15
+	60
+	68
+	76
+	84
+	92
+	37
+	45
+	53
+	61
+	6
+	14
+	22
+	30
+	38
+	83
+	91
+	99
+	7
+	52
+	60
+	68
+	76
+	84
+	29
+	37
+	45
+	53
+	61
+	6
+	14
+	22
+	30
+	75
+	83
+	91
+	99
+	7
+	52
+	60
+	68
+	76
+	21
+	29
+	37
+	45
+	53
+	98
+	6
+	14
+	22
+	30
+	75
+	83
+	91
+	99
+	44
+	52
+	60
+	68
+	76
+	21
+	29
+	37
+	45
+	53
+	98
+	6
+	14
+	22
+	67
+	75
+	83
+	91
+	99
+	44
+	52
+	60
+	68
+	13
+	21
+	29
+	37
+	45
+	90
+	98
+	6
+	14
+	22
+	67
+	75
+	83
+	91
+	36
+	44
+	52
+	60
+	68
+	13
+	21
+	29
+	37
+	45
+	90
+	98
+	6
+	14
+	59
+	67
+	75
+	83
+	91
+	36
+	44
+	52
+	60
+	5
+	13
+	21
+	29
+	37
+	82
+	90
+	98
+	6
+	14
+	59
+	67
+	75
+	83
+	28
+	36
+	44
+	52
+	60
+	5
+	13
+	21
+	29
+	74
+	82
+	90
+	98
+	6
+	51
+	59
+	67
+	75
+	83
+	28
+	36
+	44
+	52
+	97
+	5
+	13
+	21
+	29
+	74
+	82
+	90
+	98
+	6
+	51
+	59
+	67
+	75
+	20
+	28
+	36
+	44
+	52
+	97
+	5
+	13
+	21
+	66
+	74
+	82
+	90
+	98
+	43
+	51
+	59
+	67
+	75
+	20
+	28
+	36
+	44
+	89
+	97
+	5
+	13
+	21
+	66
+	74
+	82
+	90
+	35
+	43
+	51
+	59
+	67
+	12
+	20
+	28
+	36
+	44
+	89
+	97
+	5
+	13
+	58
+	66
+	74
+	82
+	90
+	35
+	43
+	51
+	59
+	67
+	12
+	20
+	28
+	36
+	81
+	89
+	97
+	5
+	13
+	58
+	66
+	74
+	82
+	27
+	35
+	43
+	51
+	59
+	4
+	12
+	20
+	28
+	36
+	81
+	89
+	97
+	5
+	50
+	58
+	66
+	74
+	82
+	27
+	35
+	43
+	51
+	59
+	4
+	12
+	20
+	28
+	73
+	81
+	89
+	97
+	5
+	50
+	58
+	66
+	74
+	19
+	27
+	35
+	43
+	51
+	96
+	4
+	12
+	20
+	28
+	73
+	81
+	89
+	97
+	42
+	50
+	58
+	66
+	74
+	19
+	27
+	35
+	43
+	88
+	96
+	4
+	12
+	20
+	65
+	73
+	81
+	89
+	97
+	42
+	50
+	58
+	66
+	11
+	19
+	27
+	35
+	43
+	88
+	96
+	4
+	12
+	20
+	65
+	73
+	81
+	89
+	34
+	42
+	50
+	58
+	66
+	11
+	19
+	27
+	35
+	80
+	88
+	96
+	4
+	12
+	57
+	65
+	73
+	81
+	89
+	34
+	42
+	50
+	58
+	3
+	11
+	19
+	27
+	35
+	80
+	88
+	96
+	4
+	12
+	57
+	65
+	73
+	81
+	26
+	34
+	42
+	50
+	58
+	3
+	11
+	19
+	27
+	72
+	80
+	88
+	96
+	4
+	49
+	57
+	65
+	73
+	81
+	26
+	34
+	42
+	50
+	95
+	3
+	11
+	19
+	27
+	72
+	80
+	88
+	96
+	41
+	49
+	57
+	65
+	73
+	18
+	26
+	34
+	42
+	50
+	95
+	3
+	11
+	19
+	64
+	72
+	80
+	88
+	96
+	41
+	49
+	57
+	65
+	73
+	18
+	26
+	34
+	42
+	87
+	95
+	3
+	11
+	19
+	64
+	72
+	80
+	88
+	33
+	41
+	49
+	57
+	65
+	10
+	18
+	26
+	34
+	42
+	87
+	95
+	3
+	11
+	56
+	64
+	72
+	80
+	88
+	33
+	41
+	49
+	57
+	2
+	10
+	18
+	26
+	34
+	79
+	87
+	95
+	3
+	11
+	56
+	64
+	72
+	80
+	25
+	33
+	41
+	49
+	57
+	2
+	10
+	18
+	26
+	34
+	79
+	87
+	95
+	3
+	48
+	56
+	64
+	72
+	80
+	25
+	33
+	41
+	49
+	94
+	2
+	10
+	18
+	26
+	71
+	79
+	87
+	95
+	3
+	48
+	56
+	64
+	72
+	17
+	25
+	33
+	41
+	49
+	94
+	2
+	10
+	18
+	26
+	71
+	79
+	87
+	95
+	40
+	48
+	56
+	64
+	72
+	17
+	25
+	33
+	41
+	86
+	94
+	2
+	10
+	18
+	63
+	71
+	79
+	87
+	95
+	40
+	48
+	56
+	64
+	9
+	17
+	25
+	33
+	41
+	86
+	94
+	2
+	10
+	55
+	63
+	71
+	79
+	87
+	32
+	40
+	48
+	56
+	64
+	9
+	17
+	25
+	33
+	78
+	86
+	94
+	2
+	10
+	55
+	63
+	71
+	79
+	87
+	32
+	40
+	48
+	56
+	1
+	9
+	17
+	25
+	33
+	78
+	86
+	94
+	2
+	47
+	55
+	63
+	71
+	79
+	24
+	32
+	40
+	48
+	56
+	1
+	9
+	17
+	25
+	70
+	78
+	86
+	94
+	2
+	47
+	55
+	63
+	71
+	16
+	24
+	32
+	40
+	48
+	93
+	1
+	9
+	17
+	25
+	70
+	78
+	86
+	94
+	39
+	47
+	55
+	63
+	71
+	16
+	24
+	32
+	40
+	48
+	93
+	1
+	9
+	17
+	62
+	70
+	78
+	86
+	94
+	39
+	47
+	55
+	63
+	8
+	16
+	24
+	32
+	40
+	85
+	93
+	1
+	9
+	17
+	62
+	70
+	78
+	86
+	31
+	39
+	47
+	55
+	63
+	8
+	16
+	24
+	32
+	40
+	85
+	93
+	1
+	9
+	54
+	62
+	70
+	78
+	86
+	31
+	39
+	47
+	55
+	0
+	8
+	16
+	24
+	32
+	77
+	85
+	93
+	1
+	9
+	54
+	62
+	70
+	78
+</plot>
+is the result of by drawing $10^3$ numbers in the interval $[0, 100)$ using:
+<code lolcode>
+IM IN YR LOOP UPPIN YR DRAWS WILE DIFFRINT DRAWS AN 1000
+    VISIBLE I IZ WAS_MESS YR 100 MKAY
+IM OUTTA YR LOOP
+</code>
+====== Fibonacci Number Generator ======
+The ''WAS_FIB'' function prints out the first ''ROUNDS'' number of Fibonacci numbers starting with the initialisation vectors (either ''0'' and ''1'' or ''1'' and ''1'') passed to the function as ''FIRST'' and ''SECOND''.
+<code lolcode>
+OBTW  Copyright (C) 2014 Wizardry and Steamworks - License: GNU GPLv3  TLDR
+HOW IZ I WAS_FIB YR ROUNDS AN YR FIRST AN YR SECOND
+    DIFFRINT ROUNDS AN SMALLR OF ROUNDS AN 0, O RLY?
+        YA RLY,
+            VISIBLE FIRST
+            FOUND YR I IZ WAS_FIB YR DIFF OF ROUNDS AN 1 AN YR SECOND AN YR SUM OF FIRST AN SECOND MKAY
+        NO WAI,
+            GTFO
+    OIC
+IF U SAY SO
+</code>
+An example call is:
+<code lolcode>
+I HAS A ROUNDS ITZ 10
+I HAS A FIRST ITZ 0
+I HAS A SECOND ITZ 1
+I IZ WAS_FIB YR ROUNDS AN YR FIRST AN YR SECOND MKAY
+</code>
+which prints out:
+<code lolcode>
+</code>
+Note that the edge-cases where the function is passed a ''ROUNDS'' number smaller than the initialisation vector are respected by ''WAS_FIB''.