aboutsummaryrefslogtreecommitdiff
path: root/core/container/bit_array/doc.odin
blob: 52e252d8ae98651e31836cfa5c0a50115f05dff6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
package dynamic_bit_array

/*
	The Bit Array can be used in several ways:

	-- By default you don't need to instantiate a Bit Array:

		package test

		import "core:fmt"
		import "core:container/bit_array"

		main :: proc() {
			using bit_array

			bits: Bit_Array

			// returns `true`
			fmt.println(set(&bits, 42))

			// returns `false`, `false`, because this Bit Array wasn't created to allow negative indices.
			was_set, was_retrieved := get(&bits, -1)
			fmt.println(was_set, was_retrieved) 
			destroy(&bits)
		}

	-- A Bit Array can optionally allow for negative indices, if the mininum value was given during creation:

		package test

		import "core:fmt"
		import "core:container/bit_array"

		main :: proc() {
			Foo :: enum int {
				Negative_Test = -42,
				Bar           = 420,
				Leaves        = 69105,
			}

			using bit_array

			bits := create(int(max(Foo)), int(min(Foo)))
			defer destroy(bits)

			fmt.printf("Set(Bar):           %v\n",     set(bits, Foo.Bar))
			fmt.printf("Get(Bar):           %v, %v\n", get(bits, Foo.Bar))
			fmt.printf("Set(Negative_Test): %v\n",     set(bits, Foo.Negative_Test))
			fmt.printf("Get(Leaves):        %v, %v\n", get(bits, Foo.Leaves))
			fmt.printf("Get(Negative_Test): %v, %v\n", get(bits, Foo.Negative_Test))
			fmt.printf("Freed.\n")
		}
*/