Skip to content

docs: clarify numeric prefix conversions - #227

Draft
allenflux wants to merge 1 commit into
d99kris:masterfrom
allenflux:allenflux/docs-numeric-prefix-conversion
Draft

allenflux wants to merge 1 commit into
d99kris:masterfrom
allenflux:allenflux/docs-numeric-prefix-conversion

Conversation

@allenflux

Copy link
Copy Markdown

The README currently suggests all non-numeric cell content throws. Default conversions follow the standard conversion routines and may accept a numeric prefix, so 12abc becomes 12 and a configured fallback does not apply. Clarify this behavior, add a per-call converter example that rejects unconsumed characters, and explain that disabling mNumericLocale affects floating-point conversion only.

This addresses the documentation concern acknowledged in #224. Numeric conversion behavior remains as the maintainer requested.

Validation: the exact README callback compiled as C++11 with warnings treated as errors; 18 real public-API checks verified prefixes, fallbacks, locale settings and strict conversion. All 112 official unit tests passed. Independent automated review repeated the example checks and verified that src/rapidcsv.h is unchanged.

AI assistance: OpenAI Codex helped inspect the behavior, clarify the documentation and independently validate the example.

@d99kris d99kris self-assigned this Oct 16, 2026
@d99kris
d99kris self-requested a review October 21, 2026 11:26
@d99kris d99kris removed their assignment Oct 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants