This tweaks the code and comments added in commit36d7748e"Merge pull request #90 from sarastro-nl/improvement/optimize-SDC" and commitd46220ca"optimize SDC". Both of those two commit messages are short but see the discussion re algorithmic changes on PR 87 (yes, 87, not 90): https://github.com/google/wuffs/pull/87 Also run clang-format. Also update doc/changelog.md Compared to before commitd46220ca"optimize SDC", when running script/manual-test-parse-number-f64.cc and disabling both the etc__parse_number_f64_eisel_lemire function and the "If both man and (10 ** exp10) are exactly representable by a double" fast path, the tests still pass but the number of etc__high_prec_dec__small_lshift and etc__high_prec_dec__small_rshift calls drop: Function Before After Ratio lshift 31174584 25762258 82.64% = 100% - 17.36% rshift 21592604 20982502 97.17% = 100% - 2.83% The time taken drops from 15.984s to 13.710s (85.77% = 100% - 14.23%). To repeat, these are the improvements after disabling the Eisel-Lemire and other fast paths. Simple Decimal Conversion is the rarely invoked fallback parse_number_f64 algorithm. The practical improvement (with Eisel-Lemire etc enabled) is smaller.
Releases (in the C Programming Language)
Wuffs the Library ships as a "single file C library", also known as a "header file library".
To use that library in your C/C++ project, you just need to copy one file from
this directory, or otherwise integrate that one file into your build system.
Typically, pick the latest stable version (but not the unsupported snapshot),
with a filename like wuffs-vMAJOR.MINOR.c for version MAJOR.MINOR.
To use that single file as a "foo.c"-like implementation, instead of a
"foo.h"-like header, #define WUFFS_IMPLEMENTATION before #include'ing or
compiling it.
Latest Stable Version
Version 0.2 (December 2019) is the latest stable version. Stable means that its API won't change any further, but being a "version 0.x" means that:
- It will not have long term support.
- Newer versions make no promises about compatibility.
Mirror
Wuffs' canonical repository is located at
github.com/google/wuffs. If you just want to
use Wuffs-the-library in its C form (instead of modifying its Wuffs form or
otherwise needing Wuffs-the-language tools), a mirror of just the release/c
directory is located at
github.com/google/wuffs-mirror-release-c.
By excluding everything else, the mirror is much smaller than and changes much
less frequently than the canonical repository.