aboutsummaryrefslogtreecommitdiffstats
path: root/core/module-text.h
blob: 2b6827fa686a5868ead977c42d8ec033ac58981d (plain)
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
#ifndef PURE_MODULE_TEXT_H
#define PURE_MODULE_TEXT_H
#include "flow.h"
#include "state.h"
#include <stdbool.h>
#include <stddef.h>

/* Text helpers of the module executor. Text is valid UTF-8; a character is a
 * Unicode scalar value, so every position these return is a scalar boundary. */

/* Strict UTF-8: no overlongs, surrogates or values past U+10FFFF. state
 * carries a sequence split across spans; start it at 0 and finish with
 * pure_utf8_complete. */
bool pure_utf8_step(unsigned *state, PureSpan span);
bool pure_utf8_complete(unsigned state);
bool pure_utf8_valid(PureSpan span);

/* Scalars (bytes that are not 10xxxxxx) and newlines in a span. */
size_t pure_utf8_scalars(PureSpan span);
size_t pure_utf8_newlines(PureSpan span);

/* Shortest decimal that reads back to the same finite double: integers
 * below 1e15 without a point or exponent, otherwise %g form with a trimmed
 * exponent. -0 prints as 0. Returns the length written (at most 32). */
size_t pure_format_number(double value, char out[32]);

/* A number written as JSON writes one, -?(0|[1-9][0-9]*)(.[0-9]+)?([eE][+-]?[0-9]+)?, as the nearest double (ties to
 * even): false where the text is not one or its value is not finite (027's NUM_PARSE). */
bool pure_parse_number(const unsigned char *text, size_t size, double *value);

/* Positions in one version of a text draft (size is version.bytes). */
size_t pure_text_step(const PureDraft *, PureVersion, size_t position, double count);
size_t pure_text_line_step(const PureDraft *, PureVersion, size_t position, double count);
size_t pure_text_line_start(const PureDraft *, PureVersion, size_t position);
size_t pure_text_line_end(const PureDraft *, PureVersion, size_t position);
/* Scalars (unit 0) or line breaks (unit 1: the line, counting from 0) before position. */
size_t pure_text_count(const PureDraft *, PureVersion, size_t position, unsigned unit);
#endif