raysense 0.12.0

Architectural X-ray for your codebase. Live, local, agent-ready.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77

/*
 *   Copyright (c) 2025-2026 Anton Kundenko <singaraiona@gmail.com>
 *   All rights reserved.

 *   Permission is hereby granted, free of charge, to any person obtaining a copy
 *   of this software and associated documentation files (the "Software"), to deal
 *   in the Software without restriction, including without limitation the rights
 *   to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 *   copies of the Software, and to permit persons to whom the Software is
 *   furnished to do so, subject to the following conditions:

 *   The above copyright notice and this permission notice shall be included in all
 *   copies or substantial portions of the Software.

 *   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 *   IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 *   FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 *   AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 *   LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 *   OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 *   SOFTWARE.
 */

#ifndef RAY_CORE_NUMPARSE_H
#define RAY_CORE_NUMPARSE_H

/* ============================================================================
 * numparse — unified (ptr, len) → value parsers
 *
 * Used by both the language tokenizer (src/lang/parse.c) and the CSV
 * reader (src/io/csv.c).  All parsers share the same shape:
 *
 *     size_t consumed = ray_parse_X(src, len, &out);
 *
 *   - returns the number of bytes consumed from `src`
 *   - 0 means "no progress" — parse failed at byte 0, *out unchanged
 *   - the language tokenizer advances its cursor by `consumed`
 *   - the CSV reader treats `consumed != len` as a null/invalid field
 *
 * No leading whitespace is stripped; callers strip first if they need to.
 * Optional sign characters (`+` / `-`) ARE consumed.
 *
 * SWAR primitives are also exported (used by fast date / time parsers
 * that consume fixed-width digit groups).
 * ============================================================================ */

#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>

#ifdef __cplusplus
extern "C" {
#endif

size_t ray_parse_i64(const char *src, size_t len, int64_t  *dst);
size_t ray_parse_i32(const char *src, size_t len, int32_t  *dst);
size_t ray_parse_f64(const char *src, size_t len, double   *dst);
size_t ray_parse_u64_hex(const char *src, size_t len, uint64_t *dst);

/* ----------------------------------------------------------------------------
 * SWAR (SIMD Within A Register) digit primitives.
 *
 * Caller must guarantee 8 readable bytes at `p` for the 8-digit forms,
 * 4 for the 4-digit forms.  All loads are unaligned via memcpy.
 * Little-endian assumed (x86_64 / aarch64 in normal mode).
 * ---------------------------------------------------------------------------- */

bool     ray_is_8_digits   (const void *p);
bool     ray_is_4_digits   (const void *p);
uint64_t ray_parse_8_digits(const void *p);
uint32_t ray_parse_4_digits(const void *p);

#ifdef __cplusplus
}
#endif

#endif /* RAY_CORE_NUMPARSE_H */