saving.

Author: lemire

.github/workflows/ubuntu20.yml .github/workflows/ubuntu24.yml.github/workflows/ubuntu20.yml renamed to .github/workflows/ubuntu24.yml

@@ -1,4 +1,4 @@
-name: Ubuntu 20.04 CI (GCC 9.4 and 10, LLVM 10 and 11)
+name: Ubuntu 24.04 CI (GCC 13, 14, LLVM 17, 18)
 
 on:
   push:
@@ -13,17 +13,19 @@ jobs:
     if: >-
       ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
       ! contains(toJSON(github.event.commits.*.message), '[skip github]')
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-24.04
     strategy:
       fail-fast: false
       matrix:
         include:
           - {compiler: gcc}
-          - {compiler: gcc-10}
+          - {compiler: gcc-13}
+          - {compiler: gcc-14}
           - {compiler: clang}
-          - {compiler: clang-11}
+          - {compiler: clang-17}
+          - {compiler: clang-18}
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: Use cmake (debug)
         run: |
           mkdir builddebug &&

.github/workflows/vs16.yml

@@ -1,4 +1,4 @@
-name: VS16-CI
+name: VS-Latest-CI
 
 on:
   push:
@@ -13,23 +13,23 @@ jobs:
     if: >-
       ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
       ! contains(toJSON(github.event.commits.*.message), '[skip github]')
-    name: windows-vs16
-    runs-on: windows-2019
+    name: windows-2025
+    runs-on: windows-2025
     strategy:
       fail-fast: false
       matrix:
         include:
-          - {gen: Visual Studio 16 2019, mode: , arch: Win32, static: ON}
-          - {gen: Visual Studio 16 2019, mode: , arch: Win32, static: OFF}
-          - {gen: Visual Studio 16 2019, mode: , arch: x64, static: ON}
-          - {gen: Visual Studio 16 2019, mode: , arch: x64, static: OFF}
-          - {gen: Visual Studio 16 2019, mode: -T ClangCL, arch: Win32, static: ON}
-          - {gen: Visual Studio 16 2019, mode: -T ClangCL, arch: Win32, static: OFF}
-          - {gen: Visual Studio 16 2019, mode: -T ClangCL, arch: x64, static: ON}
-          - {gen: Visual Studio 16 2019, mode: -T ClangCL, arch: x64, static: OFF}
+          - {gen: Visual Studio 17 2022, mode: , arch: Win32, static: ON}
+          - {gen: Visual Studio 17 2022, mode: , arch: Win32, static: OFF}
+          - {gen: Visual Studio 17 2022, mode: , arch: x64, static: ON}
+          - {gen: Visual Studio 17 2022, mode: , arch: x64, static: OFF}
+          - {gen: Visual Studio 17 2022, mode: -T ClangCL, arch: Win32, static: ON}
+          - {gen: Visual Studio 17 2022, mode: -T ClangCL, arch: Win32, static: OFF}
+          - {gen: Visual Studio 17 2022, mode: -T ClangCL, arch: x64, static: ON}
+          - {gen: Visual Studio 17 2022, mode: -T ClangCL, arch: x64, static: OFF}
     steps:
     - name: checkout
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
     - name: Configure
       run: |
         cmake -G "${{matrix.gen}}" -A ${{matrix.arch}} "${{matrix.mode}}" -DSIMDJSON_DEVELOPER_MODE=ON -DSIMDJSON_COMPETITION=OFF -DSIMDJSON_BUILD_STATIC=${{matrix.static}} -DSTREAMVBYTE_ENABLE_EXAMPLES=ON -DSTREAMVBYTE_ENABLE_TESTS=ON -DSTREAMVBYTE_WALL=ON -DSTREAMVBYTE_WERROR=ON -B build

CMakeLists.txt

@@ -161,6 +161,11 @@ option(STREAMVBYTE_ENABLE_EXAMPLES "Enable examples for streamvbyte" OFF)
 if(STREAMVBYTE_ENABLE_EXAMPLES)
     add_executable(example ${PROJECT_SOURCE_DIR}/examples/example.c)
     target_link_libraries(example streamvbyte)
+
+    if(NOT MSVC)
+        add_executable(compress_decimal_encoded_integers ${PROJECT_SOURCE_DIR}/examples/compress_decimal_encoded_integers.c)
+        target_link_libraries(compress_decimal_encoded_integers streamvbyte)
+    endif()
 endif()
 
 option(STREAMVBYTE_ENABLE_TESTS "Enable unit tests for streamvbyte" OFF)

README.md

@@ -1,9 +1,9 @@
 streamvbyte
 ===========
 [![Ubuntu 22.04 CI (GCC 9, 10, 11 and 12, LLVM 12, 13, 14)](https://github.com/lemire/streamvbyte/actions/workflows/ubuntu22.yml/badge.svg)](https://github.com/lemire/streamvbyte/actions/workflows/ubuntu22.yml)
-[![Ubuntu 20.04 CI (GCC 9.4 and 10, LLVM 10 and 11)](https://github.com/lemire/streamvbyte/actions/workflows/ubuntu20.yml/badge.svg)](https://github.com/lemire/streamvbyte/actions/workflows/ubuntu20.yml)
+[![Ubuntu 24.04 CI (GCC 13, 14, LLVM 17, 18)](https://github.com/lemire/streamvbyte/actions/workflows/ubuntu24.yml/badge.svg)](https://github.com/lemire/streamvbyte/actions/workflows/ubuntu24.yml)
 [![macOS 11 CI (LLVM 13, GCC 10, 11, 12)](https://github.com/lemire/streamvbyte/actions/workflows/macos.yml/badge.svg)](https://github.com/lemire/streamvbyte/actions/workflows/macos.yml)
-[![VS16-CI](https://github.com/lemire/streamvbyte/actions/workflows/vs16.yml/badge.svg)](https://github.com/lemire/streamvbyte/actions/workflows/vs16.yml)
+[![VS-Latest-CI](https://github.com/lemire/streamvbyte/actions/workflows/vs16.yml/badge.svg)](https://github.com/lemire/streamvbyte/actions/workflows/vs16.yml)
 [![VS17-CI](https://github.com/lemire/streamvbyte/actions/workflows/vs.yml/badge.svg)](https://github.com/lemire/streamvbyte/actions/workflows/vs.yml)
 
 StreamVByte is a new integer compression technique that applies SIMD instructions (vectorization) to
@@ -44,6 +44,19 @@ This library is used by
 
 See `examples/example.c` for an example.
 
+The `examples/compress_decimal_encoded_integers.c` program reads decimal-encoded
+32-bit unsigned integers (whitespace-separated) from a text file, compresses
+them with StreamVByte, and reports the resulting compression ratio. When the
+examples are enabled in the CMake build (`-DSTREAMVBYTE_ENABLE_EXAMPLES=ON`),
+it is built as `compress_decimal_encoded_integers` and may be invoked as:
+
+```
+./build/compress_decimal_encoded_integers IN_FILENAME [OUT_FILENAME]
+```
+
+If the optional `OUT_FILENAME` is provided, the compressed bytes are written
+to that file. This example is not built under MSVC because it uses POSIX I/O.
+
 Short code sample:
 ```C
 // suppose that datain is an array of uint32_t integers