docs/src/index.md

Wed, 27 Dec 2023 17:28:33 +0100

author
Mike Becker <universe@uap-core.de>
date
Wed, 27 Dec 2023 17:28:33 +0100
changeset 775
d3f451440eef
parent 748
84a000a53d9b
permissions
-rw-r--r--

ignore the intentional use-after-free

264
24f5484bae97 web doc has now proper titles
Mike Becker <universe@uap-core.de>
parents: 259
diff changeset
1 ---
24f5484bae97 web doc has now proper titles
Mike Becker <universe@uap-core.de>
parents: 259
diff changeset
2 title: Overview
24f5484bae97 web doc has now proper titles
Mike Becker <universe@uap-core.de>
parents: 259
diff changeset
3 ---
259
2f5dea574a75 modules documentation
Mike Becker <universe@uap-core.de>
parents: 256
diff changeset
4
2f5dea574a75 modules documentation
Mike Becker <universe@uap-core.de>
parents: 256
diff changeset
5 Welcome to the UAP Common Extensions.
2f5dea574a75 modules documentation
Mike Becker <universe@uap-core.de>
parents: 256
diff changeset
6
2f5dea574a75 modules documentation
Mike Becker <universe@uap-core.de>
parents: 256
diff changeset
7 With this library we provide useful data structures and algorithms for common
716
bab81cf591a5 update general web documentation structure
Mike Becker <universe@uap-core.de>
parents: 390
diff changeset
8 programmatic tasks in the C language. Using the build files you can create
bab81cf591a5 update general web documentation structure
Mike Becker <universe@uap-core.de>
parents: 390
diff changeset
9 a static and a shared lib containing all units, but you may also use the UCX
bab81cf591a5 update general web documentation structure
Mike Becker <universe@uap-core.de>
parents: 390
diff changeset
10 sources in your project and compile specific units by yourself.
259
2f5dea574a75 modules documentation
Mike Becker <universe@uap-core.de>
parents: 256
diff changeset
11
333
b3ad9d1a20b7 fixes an url typo which survived surprisingly long
Mike Becker <universe@uap-core.de>
parents: 264
diff changeset
12 If you want to use this library, you can [download and install](install.html)
259
2f5dea574a75 modules documentation
Mike Becker <universe@uap-core.de>
parents: 256
diff changeset
13 the recent version.
2f5dea574a75 modules documentation
Mike Becker <universe@uap-core.de>
parents: 256
diff changeset
14 The source code is also available as Mercurial repository [at our site][1] and
2f5dea574a75 modules documentation
Mike Becker <universe@uap-core.de>
parents: 256
diff changeset
15 on [Source Forge][2].
2f5dea574a75 modules documentation
Mike Becker <universe@uap-core.de>
parents: 256
diff changeset
16
2f5dea574a75 modules documentation
Mike Becker <universe@uap-core.de>
parents: 256
diff changeset
17 [1]: https://develop.uap-core.de/hg/ucx/
2f5dea574a75 modules documentation
Mike Becker <universe@uap-core.de>
parents: 256
diff changeset
18 [2]: https://sourceforge.net/p/ucx/code/
2f5dea574a75 modules documentation
Mike Becker <universe@uap-core.de>
parents: 256
diff changeset
19
2f5dea574a75 modules documentation
Mike Becker <universe@uap-core.de>
parents: 256
diff changeset
20 ### Authors
2f5dea574a75 modules documentation
Mike Becker <universe@uap-core.de>
parents: 256
diff changeset
21
2f5dea574a75 modules documentation
Mike Becker <universe@uap-core.de>
parents: 256
diff changeset
22 Mike Becker [&lt;universe@uap-core.de&gt;](mailto:universe@uap-core.de)
2f5dea574a75 modules documentation
Mike Becker <universe@uap-core.de>
parents: 256
diff changeset
23
2f5dea574a75 modules documentation
Mike Becker <universe@uap-core.de>
parents: 256
diff changeset
24 Olaf Wintermann
2f5dea574a75 modules documentation
Mike Becker <universe@uap-core.de>
parents: 256
diff changeset
25 [&lt;olaf.wintermann@gmail.com&gt;](mailto:olaf.wintermann@gmail.com)
386
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
26
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
27 Changelog
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
28 ---------
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
29
748
84a000a53d9b add release date for UCX 3.0
Mike Becker <universe@uap-core.de>
parents: 716
diff changeset
30 ### Version 3.0 - 2023-07-09
390
d345541018fa starts ucx 3.0 development
Mike Becker <universe@uap-core.de>
parents: 386
diff changeset
31
716
bab81cf591a5 update general web documentation structure
Mike Becker <universe@uap-core.de>
parents: 390
diff changeset
32 * complete redesign from scratch
bab81cf591a5 update general web documentation structure
Mike Becker <universe@uap-core.de>
parents: 390
diff changeset
33 * collections can now store copies of objects and not just pointers
bab81cf591a5 update general web documentation structure
Mike Becker <universe@uap-core.de>
parents: 390
diff changeset
34 * collections are now dynamically implemented
bab81cf591a5 update general web documentation structure
Mike Becker <universe@uap-core.de>
parents: 390
diff changeset
35 * users of the library can specify own implementations of collections that work with the UCX API
bab81cf591a5 update general web documentation structure
Mike Becker <universe@uap-core.de>
parents: 390
diff changeset
36 * low level API for custom lists that do not use the UCX structures
bab81cf591a5 update general web documentation structure
Mike Becker <universe@uap-core.de>
parents: 390
diff changeset
37 * various fixes and improvements
bab81cf591a5 update general web documentation structure
Mike Becker <universe@uap-core.de>
parents: 390
diff changeset
38 * drops some other, rarely used, features
bab81cf591a5 update general web documentation structure
Mike Becker <universe@uap-core.de>
parents: 390
diff changeset
39 * removes testing implementation from the lib
390
d345541018fa starts ucx 3.0 development
Mike Becker <universe@uap-core.de>
parents: 386
diff changeset
40
386
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
41 ### Version 2.1 - 2019-12-30
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
42
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
43 * adds string replace functions
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
44 * adds set operations for ` UcxList` and `UcxMap`
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
45 * adds `sstrcaseprefix()` and `sstrcasesuffix()`
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
46 * improves Doxygen documentation in ucx/string.h
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
47 * adds `UcxArray` data type
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
48 * adds support for CMake builds, but main build system is still autotools
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
49
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
50 ### Version 2.0 - 2018-12-28
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
51
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
52 * some uncritical bug fixes
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
53 * overflow of `sstrnlen` now returns `SIZE_MAX` instead of zero
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
54 * adds `scstr_t` - a `const char*` variant for sstr_t
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
55 * renames utility compare functions
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
56
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
57 ### Version 1.1 - 2018-05-14
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
58
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
59 * adds missing 32 bit support to integer overflow checks
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
60 * adds `ucx_buffer_to_sstr()` macro
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
61 * adds `ucx_avl_free_content()`
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
62 * adds some more compare and distance functions in utils.h
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
63 * adds `SFMT()` and `PRIsstr` convenience macros
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
64 * destructor functions for `*_free_content()` functions are now optional
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
65
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
66 ### Version 1.0.1 - 2018-01-21
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
67
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
68 * some bug fixes
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
69 * adds integer overflow checks
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
70
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
71 ### Version 1.0 - 2017-10-28
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
72
8ebfe95077eb adds changelog to html documentation
Mike Becker <universe@uap-core.de>
parents: 333
diff changeset
73 * first stable version of UCX released

mercurial