/*
 * CDDL HEADER START
 *
 * The contents of this file are subject to the terms of the
 * Common Development and Distribution License, Version 1.0 only
 * (the "License").  You may not use this file except in compliance
 * with the License.
 *
 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
 * or http://www.opensolaris.org/os/licensing.
 * See the License for the specific language governing permissions
 * and limitations under the License.
 *
 * When distributing Covered Code, include this CDDL HEADER in each
 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
 * If applicable, add the following below this CDDL HEADER, with the
 * fields enclosed by brackets "[]" replaced with your own identifying
 * information: Portions Copyright [yyyy] [name of copyright owner]
 *
 * CDDL HEADER END
 */
/*	Copyright (c) 1984, 1986, 1987, 1988, 1989 AT&T	*/
/*	  All Rights Reserved  	*/


/*
 * Copyright (c) 1999, by Sun Microsystems, Inc.
 * All rights reserved.
 */

/* This is a private header file.				*/

/* extensible strings */

#ifndef _S_STRING_H
#define	_S_STRING_H

#include <string.h>

typedef struct string {
	char *base;	/* base of string */
	char *end;	/* end of allocated space+1 */
	char *ptr;	/* ptr into string */
} string;

/*
 * LINT:  expect lint warnings from the following macros
 * Some macros have an integer at the end, which has null effect according
 * to lint, but causes the last expression to be evaluated as an int (didn't
 * change this).
 */
#define	s_clone(s)	s_copy((s)->ptr)
#define	s_curlen(s)	((s)->ptr - (s)->base)
#define	s_dup(s)	s_copy((s)->base)
#define	s_getc(s)	(*((s)->ptr++))
#define	s_peek(s)	(*((s)->ptr))
#define	s_putc(s, c)	(((s)->ptr < (s)->end) ? \
	(*((s)->ptr)++ = (char)(c)) : s_grow((s), (c)))
#define	s_reset(s)	((s) ? (*((s)->ptr = (s)->base) = '\0', (s)) : s_new())
#define	s_restart(s)	((s)->ptr = (s)->base)
#define	s_skipc(s)	((s)->ptr++)
#define	s_space(s)	((s)->end - (s)->base)
#define	s_terminate(s)  (((s)->ptr < (s)->end) ? \
	(*(s)->ptr = 0) : (s_grow((s), 0), (s)->ptr--, 0))
#define	s_to_c(s)	((s)->base)
#define	s_ptr_to_c(s)	((s)->ptr)

#ifdef __STDC__
extern string *s_append(string *to, char *from);
extern string *s_array(char *, size_t len);
extern string *s_copy(char *);
extern void s_free(string *);
extern int s_grow(string *sp, int c);
extern string *s_new(void);
extern string *s_parse(string *from, string *to);
extern char *s_read_line(FILE *fp, string *to);
extern size_t s_read_to_eof(FILE *fp, string *to);
extern string *s_seq_read(FILE *fp, string *to, int lineortoken);
extern void s_skipwhite(string *from);
extern string *s_tok(string *, char *);
extern void s_tolower(string *);
#else
extern string *s_append();
extern string *s_array();
extern string *s_copy();
extern void s_free();
extern int s_grow();
extern string *s_new();
extern string *s_parse();
extern char *s_read_line();
extern size_t s_read_to_eof();
extern string *s_seq_read();
extern void s_skipwhite();
extern string *s_tok();
extern void s_tolower();
#endif

/* controlling the action of s_seq_read */
#define	TOKEN 0		/* read the next whitespace delimited token */
#define	LINE 1		/* read the next logical input line */
#define	s_getline(a, b) s_seq_read(a, b, LINE)
#define	s_gettoken(a, b) s_seq_read(a, b, TOKEN)

#endif /* _S_STRING_H */