/*

 * str.h

 *

 * Version: 2017-07-03

 *

 * Copyright (c) Chris Putnam 1999-2018

 *

 * Source code released under the GPL version 2

 *

 */

#ifndef STR_H

#define STR_H

#include <stdio.h>

typedef struct str {

	char *data;

	unsigned long dim;

	unsigned long len;

}  str;

str *  str_new         ( void );

void   str_delete      ( str *s );

void   str_init        ( str *s );

void   str_initstr     ( str *s, str *from );

void   str_initstrc    ( str *s, const char *initstr );

void   str_initstrsc   ( str *s, ... );

void   str_empty       ( str *s );

void   str_free        ( str *s );

void   strs_init       ( str *s, ... );

void   strs_empty      ( str *s, ... );

void   strs_free       ( str *s, ... );

str*   str_strdup ( str *s );

str*   str_strdupc( const char *p );

void   str_strcat ( str *s, str *from );

void   str_strcatc( str *s, const char *from );

void   str_strcpy ( str *s, str *from );

void   str_strcpyc( str *s, const char *from );

int    str_strcmp ( const str *s, const str *t );

int    str_strcmpc( const str *s, const char *t );

int    str_strncmp ( const str *s, const str *t,  size_t n );

int    str_strncmpc( const str *s, const char *t, size_t n );

int    str_strcasecmp ( const str *s, const str *t );

int    str_strcasecmpc( const str *s, const char *t );

char * str_strstr ( const str *s, const str *t );

char * str_strstrc( const str *s, const char *t );

void str_prepend     ( str *s, const char *addstr );

void str_mergestrs   ( str *s, ... );

void str_addchar     ( str *s, char newchar );

void str_reverse     ( str *s );

const char *str_addutf8    ( str *s, const char *p );

void str_segcat      ( str *s, char *startat, char *endat );

char *str_cpytodelim  ( str *s, char *p, const char *delim, unsigned char finalstep );

char *str_cattodelim  ( str *s, char *p, const char *delim, unsigned char finalstep );

void str_prepend     ( str *s, const char *addstr );

void str_segcpy      ( str *s, char *startat, char *endat );

void str_segdel      ( str *s, char *startat, char *endat );

void str_indxcpy     ( str *s, char *p, unsigned long start, unsigned long stop );

void str_indxcat     ( str *s, char *p, unsigned long start, unsigned long stop );

void str_fprintf     ( FILE *fp, str *s );

int  str_fget        ( FILE *fp, char *buf, int bufsize, int *pbufpos,

                          str *outs );

char * str_cstr      ( str *s );

char str_char        ( str *s, unsigned long n );

char str_revchar     ( str *s, unsigned long n );

int  str_fgetline    ( str *s, FILE *fp );

int  str_findreplace ( str *s, const char *find, const char *replace );

void str_toupper     ( str *s );

void str_tolower     ( str *s );

void str_trimstartingws( str *s );

void str_trimendingws( str *s );

void str_swapstrings ( str *s1, str *s2 );

void str_stripws     ( str *s );

int  str_match_first ( str *s, char ch );

int  str_match_end   ( str *s, char ch );

void str_trimbegin   ( str *s, unsigned long n );

void str_trimend     ( str *s, unsigned long n );

void str_pad         ( str *s, unsigned long len, char ch );

void str_copyposlen  ( str *s, str *in, unsigned long pos, unsigned long len );

void str_makepath    ( str *path, const char *dirname, const char *filename, char sep );

void str_fill        ( str *s, unsigned long n, char fillchar );

int  str_is_mixedcase( str *s );

int  str_is_lowercase( str *s );

int  str_is_uppercase( str *s );

int  str_memerr( str *s );

unsigned long str_strlen( str *s );

int  str_has_value( str *s );

int  str_is_empty( str *s );

/* #define STR_PARANOIA

 *

 * set to clear memory before it is freed or reallocated

 * note that this is slower...may be important if string

 * contains sensitive information

 */

/* #define STR_NOASSERT

 *

 * set to turn off the use of asserts (and associated call to exit)

 * in str functions...useful for library construction for

 * Linux distributions that don't want libraries calling exit, but

 * not useful during code development

 */

#endif