A TextParser object is initialised with a delimiter, which can consist of
more than one symbol.
#include <textparser.h>
// Delimiter is a comma followed by a space.
TextParser parser(", ");Optionally, an end of line string can be provided when needed.
// Strip end of line from strings.
TextParser parser(", ", "\r\n");If all fields are of the same type, we can use an array.
int a[5];
parser.parseLine("1, 2, 3, 4, 5", a);If the values should be of type float instead of int, we simply
change the type of the receiving array.
float a[5];
parser.parseLine("1, 2, 3, 4, 5", a);If the fields have different types, we can use multiple variables.
char a[4];
int b;
double c;
parser.parseLine("one, 2, 3.4", a, b, c);By default, integers are used to represent boolean values.
bool a;
parser.parseLine("0", a); // `a` contains `false`.
parser.parseLine("1", a); // `a` contains `true`.
parser.parseLine("314", a); // `a` contains `true`.For text to boolean conversion, we first need to define a global string that contains the truth value.
char const truth[] = "Yes"; // This needs to be a global string.This string can then be used to create a variable of type Bool.
Bool<truth> a;
parser.parseLine("1", a); // `a.value` contains `false`.
parser.parseLine("Yes", a); // `a.value` contains `true`.
parser.parseLine("YES", a); // `a.value` contains `false`.For categorical data, we need to define a global zero terminated list of labels.
char const* labels[] = {"red", "green", "blue", nullptr};These labels can then be used to create a variable of type Category.
Category<int, labels> a;
parser.parseLine("red", a); // `a.value` contains 0.
parser.parseLine("blue", a); // `a.value` contains 2.
parser.parseLine("yellow", a); // `a.value` contains -1.Integers in arbitrary bases are supported via the Number type.
Number<int, 16> a; // Hexadecimal number.
Number<int, 2> b; // Binary number.
parser.parseLine("0x1f, 101001", a, b);Please see the demo sketch for an example of basic usage.