lib/memcmp2.h

   1 /* Compare two memory areas with possibly different lengths.
   2    Copyright (C) 2009-2024 Free Software Foundation, Inc.
   3
   4    This file is free software: you can redistribute it and/or modify
   5    it under the terms of the GNU Lesser General Public License as
   6    published by the Free Software Foundation; either version 2.1 of the
   7    License, or (at your option) any later version.
   8
   9    This file is distributed in the hope that it will be useful,
  10    but WITHOUT ANY WARRANTY; without even the implied warranty of
  11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12    GNU Lesser General Public License for more details.
  13
  14    You should have received a copy of the GNU Lesser General Public License
  15    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
  16
  17 #ifndef MEMCMP2_H
  18 #define MEMCMP2_H
  19
  20 /* This file uses _GL_ATTRIBUTE_PURE.  */
  21 #if !_GL_CONFIG_H_INCLUDED
  22  #error "Please include config.h first."
  23 #endif
  24
  25 #include <stddef.h>
  26
  27 #ifdef __cplusplus
  28 extern "C" {
  29 #endif
  30
  31
  32 /* Compare the memory regions S1 = [s1..s1+N1-1], S2 = [s2..s2+n2-1],
  33    lexicographically.
  34    This function's result is locale independent, unlike memcoll()'s.
  35    Return a negative number if S1 < S2, a positive number if S1 > S2, or
  36    0 if S1 and S2 have the same contents.  */
  37 extern int memcmp2 (const char *s1, size_t n1, const char *s2, size_t n2)
  38   _GL_ATTRIBUTE_PURE;
  39
  40
  41 #ifdef __cplusplus
  42 }
  43 #endif
  44
  45 #endif /* MEMCMP2_H */