toolchain/gcc/newlib/libc/string/wmemchr.c

   1 /*
   2 FUNCTION
   3         <<wmemchr>>---find a wide-character in memory
   4
   5
   6 ANSI_SYNOPSIS
   7         #include <wchar.h>
   8         wchar_t *wmemchr(const wchar_t *<[s]>, wchar_t <[c]>, size_t <[n]>);
   9
  10 TRAD_SYNOPSIS
  11         wchar_t *wmemchr(<[s]>, <[c]>, <[n]>
  12         const wchar_t *<[s]>;
  13         wchar_t <[c]>;
  14         size_t <[n]>;
  15
  16 DESCRIPTION
  17         The <<wmemchr>> function locates the first occurrence of <[c]> in the
  18         initial <[n]> wide-characters of the object pointed to be <[s]>. This
  19         function is not affected by locale and all wchar_t values are treated
  20         identically.  The null wide-character and wchar_t values not
  21         corresponding to valid characters are not treated specially.
  22
  23         If <[n]> is zero, <[s]> must be a valid pointer and the function
  24         behaves as if no valid occurrence of <[c]> is found.
  25
  26 RETURNS
  27         The <<wmemchr>> function returns a pointer to the located
  28         wide-character, or a null pointer if the wide-character does not occur
  29         in the object.
  30
  31 PORTABILITY
  32 <<wmemchr>> is ISO/IEC 9899/AMD1:1995 (ISO C).
  33 No supporting OS subroutines are required.
  34 */
  35
  36 /*      $NetBSD: wmemchr.c,v 1.1 2000/12/23 23:14:37 itojun Exp $       */
  37
  38 /*-
  39  * Copyright (c)1999 Citrus Project,
  40  * All rights reserved.
  41  *
  42  * Redistribution and use in source and binary forms, with or without
  43  * modification, are permitted provided that the following conditions
  44  * are met:
  45  * 1. Redistributions of source code must retain the above copyright
  46  *    notice, this list of conditions and the following disclaimer.
  47  * 2. Redistributions in binary form must reproduce the above copyright
  48  *    notice, this list of conditions and the following disclaimer in the
  49  *    documentation and/or other materials provided with the distribution.
  50  *
  51  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  52  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  53  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  54  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  55  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  56  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  57  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  58  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  59  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  60  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  61  * SUCH DAMAGE.
  62  *
  63  *      citrus Id: wmemchr.c,v 1.2 2000/12/20 14:08:31 itojun Exp
  64  */
  65
  66
  67 #include <_ansi.h>
  68 #include <wchar.h>
  69
  70 wchar_t *
  71 _DEFUN (wmemchr, (s, c, n),
  72         _CONST wchar_t * s _AND
  73         wchar_t c _AND
  74         size_t n)
  75 {
  76   size_t i;
  77
  78   for (i = 0; i < n; i++)
  79     {
  80       if (*s == c)
  81         {
  82           /* LINTED const castaway */
  83           return (wchar_t *) s;
  84         }
  85       s++;
  86     }
  87   return NULL;
  88 }