3 * $Id: str.c,v 1.3 1999/12/22 15:41:14 mdw Exp $
5 * Functions for hacking with strings
7 * (c) 1999 Straylight/Edgeware
10 /*----- Licensing notice --------------------------------------------------*
12 * This file is part of the mLib utilities library.
14 * mLib is free software; you can redistribute it and/or modify
15 * it under the terms of the GNU Library General Public License as
16 * published by the Free Software Foundation; either version 2 of the
17 * License, or (at your option) any later version.
19 * mLib is distributed in the hope that it will be useful,
20 * but WITHOUT ANY WARRANTY; without even the implied warranty of
21 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 * GNU Library General Public License for more details.
24 * You should have received a copy of the GNU Library General Public
25 * License along with mLib; if not, write to the Free
26 * Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
30 /*----- Revision history --------------------------------------------------*
33 * Revision 1.3 1999/12/22 15:41:14 mdw
34 * Skip past trailing whitespace in str_getword.
36 * Revision 1.2 1999/05/26 20:52:57 mdw
37 * Add new `rest' argument for `str_split'.
39 * Revision 1.1 1999/05/17 20:37:01 mdw
40 * Some trivial string hacks.
44 /*----- Header files ------------------------------------------------------*/
53 /*----- Main code ---------------------------------------------------------*/
55 /* --- @str_getword@ --- *
57 * Arguments: @char **pp@ = address of pointer into string
59 * Returns: Pointer to the next space-separated word from the string,
62 * Use: Parses off space-separated words from a string.
65 char *str_getword(char **pp)
72 while (isspace((unsigned char)*p))
75 for (q = p; *q; q++) {
76 if (isspace((unsigned char)*q)) {
78 while (*q && isspace((unsigned char)*q))
91 /* --- @str_split@ --- *
93 * Arguments: @char *p@ = pointer to string
94 * @char *v[]@ = pointer to array to fill in
95 * @size_t c@ = count of strings to fill in
96 * @char **rest@ = where to store the remainder of the string
98 * Returns: Number of strings filled in.
100 * Use: Fills an array with pointers to the individual words of a
101 * string. The string is modified in place to contain zero
102 * bytes at the word boundaries, and the words have leading
103 * and trailing space stripped off. No more than @c@ words
104 * are read; the actual number is returned as the value of the
105 * function. Unused slots in the array are populated with
106 * null bytes. If there's any string left, the address of the
107 * remainder is stored in @rest@ (if it's non-null); otherwise
108 * @rest@ is set to a null pointer.
111 size_t str_split(char *p, char *v[], size_t c, char **rest)
116 while (c && (q = str_getword(&p)) != 0) {
130 /* --- @str_sanitize@ --- *
132 * Arguments: @char *d@ = destination buffer
133 * @const char *p@ = pointer to source string
134 * @size_t sz@ = size of destination buffer
138 * Use: Writes a string into a buffer, being careful not to overflow
139 * the buffer, to null terminate the result, and to prevent
140 * nasty nonprintable characters ending up in the buffer.
143 void str_sanitize(char *d, const char *p, size_t sz)
150 if (!isgraph((unsigned char)ch))
158 /*----- That's all, folks -------------------------------------------------*/