Skip to content

docs(examples): library — cfenv, C strings, text_encoding, language support, named requirements #26

Closed

Description

@homer6

Part of #20. New or expanded standard-library pages (any source, verified locally — see CLAUDE.md → Source of truth):

  • Floating-point environment <cfenv> → numerics/.
  • Null-terminated sequence utilities — byte (<cstring>, <cctype>), multibyte and wide (<cwchar>, <cuchar>, <cwctype>) → strings/ or text-processing/ (follow cppreference: text processing).
  • text_encoding (C++26) — its own page in text-processing/ (today only a mention in localization.md).
  • Language support leftovers — signals (<csignal>), non-local jumps (<csetjmp>), type_info / typeid / type_index → pages in language-support/ (today only in its README).
  • Named requirements — overview page (Cpp17* requirements, how concepts relate).

Acceptance: house skeleton, READMEs updated, snippets pass the checker.

Activity

  1. homer6 commented on Oct 31, 2026

    @homer6
    OwnerAuthor

    Delivered in #39.

    What changed

    • numerics/cfenv.md: new page on exception flags, rounding modes, feholdexcept/feupdateenv and math_errhandling, with the implementation-defined parts called out (GCC ignores #pragma STDC FENV_ACCESS; Clang honours it).
    • text-processing/null-terminated-byte-strings.md, null-terminated-multibyte-strings.md, null-terminated-wide-strings.md: new pages for <cstring>/<cctype>, <cwchar>/<cuchar> and <cwchar>/<cwctype>, following cppreference's text-processing layout.
    • text-processing/text-encoding.md: new C++26 page, linked from localization.md.
    • language-support/type-info.md, signals.md, non-local-jumps.md: new pages. language-support/README.md is now just the index (its "also in this library" note has moved into these pages).
    • named-requirements/README.md: new overview of the Cpp17/Legacy requirements, how they map to C++20 concepts, and where the two differ. Added to the master index.
    • The text-processing, numerics and master READMEs are updated.

    Why

    • These are the five bullets of docs(examples): library — cfenv, C strings, text_encoding, language support, named requirements #26. Sources: cppreference (via Perplexity), eel.is [support.signal], GCC's implementation-defined-behaviour docs, GCC bug 34678, and Clang's floating-point docs.
    • Everything was compiled and run with GCC 15.2 and Clang 22 (libc++) on macOS, and with GCC 16.2 on Linux in Docker. Outputs on the pages come from those runs, including:
      • GCC folding and moving FP operations even with the pragma and -frounding-math;
      • math_errhandling 2 on macOS vs 3 on glibc;
      • signal handlers staying installed;
      • non-volatile locals being lost after longjmp at -O2;
      • text_encoding needing -lstdc++exp;
      • debug/hardened libraries catching a <= comparator.
    • Snippet checker: the new pages give 31 checked / 0 failed on GCC 15. The full docs/examples run against the baseline has 0 new failures and exits 0.

    Still open

    • <cuchar> examples are verified only on Linux (GCC 16): macOS has no <uchar.h>. They are tagged needs=cuchar.
    • text_encoding isn't available in libc++ (Clang 22), so those blocks only compile with GCC.
    • Windows/MSVC specifics (16-bit wchar_t, type_info::name() format) are noted as not verified locally.
  2. homer6 commented on Oct 31, 2026

    @homer6
    OwnerAuthor

    Merged in #39 (05f0cf7).

    What changed

    Why

    • Merged at the owner's request after review. Checks re-run after the rebase: guidelines 0 failed, examples baseline run exits 0, links OK.

    Still open

    • Nothing for this issue.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions