newlib/libc/string/wcscat.c

   1 /*
   2 FUNCTION
   3         <<wcscat>>---concatenate two wide-character strings
   4 INDEX
   5         wcscat
   6
   7 SYNOPSIS
   8         #include <wchar.h>
   9         wchar_t *wcscat(wchar_t *__restrict <[s1]>,
  10                         const wchar_t *__restrict <[s2]>);
  11
  12 DESCRIPTION
  13         The <<wcscat>> function appends a copy of the wide-character string
  14         pointed to by <[s2]> (including the terminating null wide-character
  15         code) to the end of the wide-character string pointed to by <[s1]>.
  16         The initial wide-character code of <[s2]> overwrites the null
  17         wide-character code at the end of <[s1]>. If copying takes place between
  18         objects that overlap, the behaviour is undefined.
  19
  20 RETURNS
  21         The <<wcscat>> function returns <[s1]>;
  22         no return value is reserved to indicate an error.
  23
  24 PORTABILITY
  25 <<wcscat>> is ISO/IEC 9899/AMD1:1995 (ISO C).
  26
  27 No supporting OS subroutines are required.
  28 */
  29
  30 /*      $NetBSD: wcscat.c,v 1.1 2000/12/23 23:14:36 itojun Exp $        */
  31
  32 /*-
  33  * Copyright (c)1999 Citrus Project,
  34  * All rights reserved.
  35  *
  36  * Redistribution and use in source and binary forms, with or without
  37  * modification, are permitted provided that the following conditions
  38  * are met:
  39  * 1. Redistributions of source code must retain the above copyright
  40  *    notice, this list of conditions and the following disclaimer.
  41  * 2. Redistributions in binary form must reproduce the above copyright
  42  *    notice, this list of conditions and the following disclaimer in the
  43  *    documentation and/or other materials provided with the distribution.
  44  *
  45  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  46  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  47  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  48  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  49  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  50  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  51  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  52  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  53  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  54  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  55  * SUCH DAMAGE.
  56  *
  57  *      citrus Id: wcscat.c,v 1.1 1999/12/29 21:47:45 tshiozak Exp
  58  */
  59
  60 #include <_ansi.h>
  61 #include <wchar.h>
  62
  63 wchar_t *
  64 wcscat (wchar_t *__restrict s1,
  65         const wchar_t *__restrict s2)
  66 {
  67   wchar_t *p;
  68   wchar_t *q;
  69   const wchar_t *r;
  70
  71   p = s1;
  72   while (*p)
  73     p++;
  74   q = p;
  75   r = s2;
  76   while (*r)
  77     *q++ = *r++;
  78   *q = '\0';
  79   return s1;
  80 }