X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~mdw/git/mLib/blobdiff_plain/081e681557eb1b6223fe8f4e2551c506cd0d2d3c..e9184b1e6b4ecd04abc8c3d15dbfe773e8fde211:/str.h

diff --git a/str.h b/str.h
index ee33d11..1581e50 100644
--- a/str.h
+++ b/str.h
@@ -1,6 +1,6 @@
 /* -*-c-*-
  *
- * $Id: str.h,v 1.1 1999/05/17 20:37:01 mdw Exp $
+ * $Id: str.h,v 1.3 1999/12/10 23:42:04 mdw Exp $
  *
  * Functions for hacking with strings
  *
@@ -30,13 +30,19 @@
 /*----- Revision history --------------------------------------------------* 
  *
  * $Log: str.h,v $
+ * Revision 1.3  1999/12/10 23:42:04  mdw
+ * Change header file guard names.
+ *
+ * Revision 1.2  1999/05/26 20:52:57  mdw
+ * Add new `rest' argument for `str_split'.
+ *
  * Revision 1.1  1999/05/17 20:37:01  mdw
  * Some trivial string hacks.
  *
  */
 
-#ifndef STR_H
-#define STR_H
+#ifndef MLIB_STR_H
+#define MLIB_STR_H
 
 #ifdef __cplusplus
   extern "C" {
@@ -65,6 +71,7 @@ extern char *str_getword(char **/*pp*/);
  * Arguments:	@char *p@ = pointer to string
  *		@char *v[]@ = pointer to array to fill in
  *		@size_t c@ = count of strings to fill in
+ *		@char **rest@ = where to store the remainder of the string
  *
  * Returns:	Number of strings filled in.
  *
@@ -74,10 +81,13 @@ extern char *str_getword(char **/*pp*/);
  *		and trailing space stripped off.  No more than @c@ words
  *		are read; the actual number is returned as the value of the
  *		function.  Unused slots in the array are populated with
- *		null bytes.
+ *		null bytes.  If there's any string left, the address of the
+ *		remainder is stored in @rest@ (if it's non-null); otherwise
+ *		@rest@ is set to a null pointer.
  */
 
-extern size_t str_split(char */*p*/, char */*v*/[], size_t /*c*/);
+extern size_t str_split(char */*p*/, char */*v*/[],
+			size_t /*c*/, char **/*rest*/);
 
 /* --- @str_sanitize@ --- *
  *