summaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
authorTyge Løvset <[email protected]>2022-09-28 11:57:39 +0200
committerTyge Løvset <[email protected]>2022-09-28 11:57:39 +0200
commit9d51766d2e1d1c3c0d9550d0cb839203633d6ec6 (patch)
tree31ef8f715e78321bbef1b64da7fe6c71ad3e8f78
parent0f755b3ba05dd629bd56f1b356c1bcc2214222a9 (diff)
downloadSTC-modified-9d51766d2e1d1c3c0d9550d0cb839203633d6ec6.tar.gz
STC-modified-9d51766d2e1d1c3c0d9550d0cb839203633d6ec6.zip
A few docs changes.
-rw-r--r--README.md13
-rw-r--r--docs/ccommon_api.md2
2 files changed, 7 insertions, 8 deletions
diff --git a/README.md b/README.md
index 5aee6492..cda096ad 100644
--- a/README.md
+++ b/README.md
@@ -26,7 +26,7 @@ in the future, and do minor modifications.
Containers
----------
-- [***ccommon*** - **High-level algorithms on containers**](docs/ccommon_api.md)
+- [***ccommon*** - Generic algorithms and macros](docs/ccommon_api.md)
- [***carc*** - **std::shared_ptr** alike type](docs/carc_api.md)
- [***carr2***, ***carr3*** - 2D and 3D **array** types](docs/carray_api.md)
- [***cbits*** - **std::bitset** alike type](docs/cbits_api.md)
@@ -467,19 +467,18 @@ Memory efficiency
## API changes summary V4.0
- Added **cregex** with documentation - powerful regular expressions.
-- Added: `c_forfilter`: Iteration with "piped" filtering using && operator. 4 built-in filters.
-- Added: `c_forwhile`: *c_foreach* iteration with extra predicate.
-- Added: **crange**: Number generator type, which can be iterated (e.g. with *c_forfilter*).
+- Added: `c_forfilter`: container iteration with "piped" filtering using && operator. 4 built-in filters.
+- Added: `c_forwhile`: *c_foreach* container iteration with extra predicate.
+- Added: **crange**: number generator type, which can be iterated (e.g. with *c_forfilter*).
- Added back **coption** - command line argument parsing.
- New + renamed loop iteration/scope macros:
- - `c_forlist`: macro replacing `c_forarray` and `c_apply`. More user friendly.
- - `c_forloop`: macro replacing `c_forrange`. Uses 'long long' as iterator type.
+ - `c_forlist`: macro replacing `c_forarray` and `c_apply`. Iterate a compound literal list.
+ - `c_forloop`: macro replacing `c_forrange`. Iterate a `long long` type number sequence.
- `c_with`: macro renamed from `c_autovar`. Like Python's **with** statement.
- `c_scope`: macro renamed from `c_autoscope`.
- `c_defer`: macro renamed from `c_autodefer`. Resembles Go's and Zig's **defer**.
- Updated **cstr**, now always takes self as pointer, like all containers except csview.
- Updated **cvec**, **cdeq**, changed `*_range*` function names.
-[See detailed changes for version 3](#version-3).
## Changes version 3.8
- Overhauled some **cstr** and **csview** API:
diff --git a/docs/ccommon_api.md b/docs/ccommon_api.md
index 40a181dc..912601e7 100644
--- a/docs/ccommon_api.md
+++ b/docs/ccommon_api.md
@@ -1,4 +1,4 @@
-# STC [ccommon](../include/stc/ccommon.h): RAII and iterator macros
+# STC [ccommon](../include/stc/ccommon.h): Generic algorithms and macros
The following macros are recommended to use, and they safe/have no side-effects.