#ifndef _STRING_UTIL_H
#define _STRING_UTIL_H

#include <string.h>

/* like strtok(3), but without state, and doesn't modify s.  Return
 * value is indicated by pointer and length, not null terminator.
 *
 * Usage pattern:
 *
 * const char *tok = input;
 * const char *delim = " \t";
 * size_t tok_len = 0;
 *
 * while ((tok = strtok_len (tok + tok_len, delim, &tok_len)) != NULL) {
 *     // do stuff with string tok of length tok_len
 * }
 */

char *strtok_len (char *s, const char *delim, size_t *len);

/* Construct a boolean term query with the specified prefix (e.g.,
 * "id") and search term, quoting term as necessary.
 *
 * Output is into buf; it may be talloc_realloced.
 * Return: 0 on success, non-zero on memory allocation failure.
 */
int make_boolean_term (void *talloc_ctx, const char *prefix, const char *term,
		       char **buf, size_t *len);

/* Parse a boolean term query produced by make_boolean_term, returning
 * the prefix in *prefix_out and the term in *term_out.  *prefix_out
 * and *term_out will be talloc'd with context ctx.
 *
 * Return: 0 on success, non-zero on parse error (including trailing
 * data in str).
 */
int
parse_boolean_term (void *ctx, const char *str,
		    char **prefix_out, char **term_out);

#endif