summaryrefslogtreecommitdiff
path: root/README.org
blob: 4fe05c9388f01cf36b30ef7728e2dbd36f6e2f7b (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
* libfud

An exception-free, UB-minimizing, library for UTF8 strings and containers with
user controlled allocators.

** Design Principles

+ Full control over allocations, even the default allocator.
+ Zero exceptions, zero exceptions to zero exceptions.
+ Assertions in production release for invariants.
+ Configurable run-time assertions for indexing.
+ Safe API for users intolerant to run-time assertions for indexing.
+ Readable, understandable code.
+ Minimize undefined behavior in the API to a subset which is only decidable at
  run-time.
+ Minimize runtime undefined behavior as much as possible.

** Relatively mature features

+ Statically sized arrays
+ String Views

** Unstable features

+ Customizable allocator model
+ Dynamically sized vectors taking an allocator
+ Dynamically sized strings taking an allocator
+ Unicode support with UTF8 encoding
+ Formatting à la =std::format=
+ Wrappers around C files
+ CSV parsing