usr.bin/make/str.h

   1 /*-
   2  * Copyright (c) 1988, 1989, 1990, 1993
   3  *      The Regents of the University of California.  All rights reserved.
   4  * Copyright (c) 1989 by Berkeley Softworks
   5  * All rights reserved.
   6  *
   7  * This code is derived from software contributed to Berkeley by
   8  * Adam de Boor.
   9  *
  10  * Redistribution and use in source and binary forms, with or without
  11  * modification, are permitted provided that the following conditions
  12  * are met:
  13  * 1. Redistributions of source code must retain the above copyright
  14  *    notice, this list of conditions and the following disclaimer.
  15  * 2. Redistributions in binary form must reproduce the above copyright
  16  *    notice, this list of conditions and the following disclaimer in the
  17  *    documentation and/or other materials provided with the distribution.
  18  * 3. All advertising materials mentioning features or use of this software
  19  *    must display the following acknowledgement:
  20  *      This product includes software developed by the University of
  21  *      California, Berkeley and its contributors.
  22  * 4. Neither the name of the University nor the names of its contributors
  23  *    may be used to endorse or promote products derived from this software
  24  *    without specific prior written permission.
  25  *
  26  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  27  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  28  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  29  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  30  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  31  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  32  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  33  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  34  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  35  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  36  * SUCH DAMAGE.
  37  *
  38  * $FreeBSD$
  39  */
  40
  41 #ifndef str_h_44db59e6
  42 #define str_h_44db59e6
  43
  44 #include "util.h"
  45
  46 struct Buffer;
  47
  48 /**
  49  * An array of c-strings.  The pointers stored in argv, point to
  50  * strings stored in buffer.
  51  */
  52 typedef struct ArgArray {
  53         int     size;           /* size of argv array */
  54         int     argc;           /* strings referenced in argv */
  55         char    **argv;         /* array of string pointers */
  56         size_t  len;            /* size of buffer */
  57         char    *buffer;        /* data buffer */
  58 } ArgArray;
  59
  60 /*
  61  * These constants are all used by the Str_Concat function to decide how the
  62  * final string should look. If STR_ADDSPACE is given, a space will be
  63  * placed between the two strings. If STR_ADDSLASH is given, a '/' will
  64  * be used instead of a space. If neither is given, no intervening characters
  65  * will be placed between the two strings in the final output.
  66  */
  67 #define STR_ADDSPACE    0x01    /* add a space when Str_Concat'ing */
  68 #define STR_ADDSLASH    0x04    /* add a slash when Str_Concat'ing */
  69
  70 void ArgArray_Init(ArgArray *);
  71 void ArgArray_Done(ArgArray *);
  72
  73 char *str_concat(const char *, const char *, int);
  74 void brk_string(ArgArray *, const char [], Boolean);
  75 char *MAKEFLAGS_quote(const char *);
  76 void MAKEFLAGS_break(ArgArray *, const char []);
  77 int Str_Match(const char *, const char *);
  78 const char *Str_SYSVMatch(const char *, const char *, int *);
  79 void Str_SYSVSubst(struct Buffer *, const char *, const char *, int);
  80
  81 #endif /* str_h_44db59e6 */