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
78
79
80
81
82
|
/* SPDX-License-Identifier: GPL-2.0-or-later */
#pragma once
#include "BLI_string_ref.hh"
/*
* Various text parsing utilities used by OBJ importer.
* The utilities are not directly usable by other formats, since
* they treat backslash (\) as a whitespace character (OBJ format
* allows backslashes to function as a line-continuation character).
*
* Many of these functions take two pointers (p, end) indicating
* which part of a string to operate on, and return a possibly
* changed new start of the string. They could be taking a StringRef
* as input and returning a new StringRef, but this is a hot path
* in OBJ parsing, and the StringRef approach does lose performance
* (mostly due to return of StringRef being two register-size values
* instead of just one pointer).
*/
namespace blender::io::obj {
/**
* Fetches next line from an input string buffer.
*
* The returned line will not have '\n' characters at the end;
* the `buffer` is modified to contain remaining text without
* the input line.
*
* Note that backslash (\) character is treated as a line
* continuation.
*/
StringRef read_next_line(StringRef &buffer);
/**
* Drop leading white-space from a string part.
* Note that backslash character is considered white-space.
*/
const char *drop_whitespace(const char *p, const char *end);
/**
* Drop leading non-white-space from a string part.
* Note that backslash character is considered white-space.
*/
const char *drop_non_whitespace(const char *p, const char *end);
/**
* Parse an integer from an input string.
* The parsed result is stored in `dst`. The function skips
* leading white-space unless `skip_space=false`. If the
* number can't be parsed (invalid syntax, out of range),
* `fallback` value is stored instead.
*
* Returns the start of remainder of the input string after parsing.
*/
const char *parse_int(
const char *p, const char *end, int fallback, int &dst, bool skip_space = true);
/**
* Parse a float from an input string.
* The parsed result is stored in `dst`. The function skips
* leading white-space unless `skip_space=false`. If the
* number can't be parsed (invalid syntax, out of range),
* `fallback` value is stored instead.
*
* Returns the start of remainder of the input string after parsing.
*/
const char *parse_float(
const char *p, const char *end, float fallback, float &dst, bool skip_space = true);
/**
* Parse a number of white-space separated floats from an input string.
* The parsed `count` numbers are stored in `dst`. If a
* number can't be parsed (invalid syntax, out of range),
* `fallback` value is stored instead.
*
* Returns the start of remainder of the input string after parsing.
*/
const char *parse_floats(const char *p, const char *end, float fallback, float *dst, int count);
} // namespace blender::io::obj
|