summaryrefslogtreecommitdiff
path: root/lib/splitstring.h
blob: 841e91f75d5708903dd91c67420be5fea6270226 (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
39
40
41
42
43
44
/* splitstring.h -- split a const string into fields.
   Copyright (C) 2011-2023 Free Software Foundation, Inc.

   This program is free software: you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation, either version 3 of the License, or
   (at your option) any later version.

   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this program.  If not, see <https://www.gnu.org/licenses/>.
*/
/*
 * Written by James Youngman.
 */
#ifndef SPLITSTRING_H
# define SPLITSTRING_H

/* Split a string into fields.   The string is never modified.
 *
 * A false return value indicates that there are no more fields.
 * Otherwise the next field is at the poisition indicated by *POS and
 * has length *LEN.
 *
 * Set FIRST to true only on the first call for any given value of s.
 * *POS and *LEN do not need to be initialized in this case.
 * On subsequent calls, these values should be left at the values
 * set by the last call.
 *
 * Any character in SEPARATORS is taken to be a field separator.
 * Consecutive field separators are taken to indicate the presence of
 * an empty field.
 */
# include <stdbool.h>
# include <stddef.h>

bool splitstring(const char *s, const char *separators,
		 bool first, size_t *pos, size_t *len);

#endif