Utilities/cmcurl/lib/strcase.c

   1 /***************************************************************************
   2  *                                  _   _ ____  _
   3  *  Project                     ___| | | |  _ \| |
   4  *                             / __| | | | |_) | |
   5  *                            | (__| |_| |  _ <| |___
   6  *                             \___|\___/|_| \_\_____|
   7  *
   8  * Copyright (C) 1998 - 2022, Daniel Stenberg, <daniel@haxx.se>, et al.
   9  *
  10  * This software is licensed as described in the file COPYING, which
  11  * you should have received as part of this distribution. The terms
  12  * are also available at https://curl.se/docs/copyright.html.
  13  *
  14  * You may opt to use, copy, modify, merge, publish, distribute and/or sell
  15  * copies of the Software, and permit persons to whom the Software is
  16  * furnished to do so, under the terms of the COPYING file.
  17  *
  18  * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
  19  * KIND, either express or implied.
  20  *
  21  * SPDX-License-Identifier: curl
  22  *
  23  ***************************************************************************/
  24
  25 #include "curl_setup.h"
  26
  27 #include <curl/curl.h>
  28
  29 #include "strcase.h"
  30
  31 /* Mapping table to go from lowercase to uppercase for plain ASCII.*/
  32 static const unsigned char touppermap[256] = {
  33 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21,
  34 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40,
  35 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59,
  36 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78,
  37 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 65,
  38 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84,
  39 85, 86, 87, 88, 89, 90, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133,
  40 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149,
  41 150, 151, 152, 153, 154, 155, 156, 157, 158, 159, 160, 161, 162, 163, 164, 165,
  42 166, 167, 168, 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181,
  43 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194, 195, 196, 197,
  44 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213,
  45 214, 215, 216, 217, 218, 219, 220, 221, 222, 223, 224, 225, 226, 227, 228, 229,
  46 230, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 241, 242, 243, 244, 245,
  47 246, 247, 248, 249, 250, 251, 252, 253, 254, 255
  48 };
  49
  50 /* Mapping table to go from uppercase to lowercase for plain ASCII.*/
  51 static const unsigned char tolowermap[256] = {
  52 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21,
  53 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41,
  54 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61,
  55 62, 63, 64, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110,
  56 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 91, 92, 93, 94, 95,
  57 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111,
  58 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127,
  59 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143,
  60 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159,
  61 160, 161, 162, 163, 164, 165, 166, 167, 168, 169, 170, 171, 172, 173, 174, 175,
  62 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 187, 188, 189, 190, 191,
  63 192, 193, 194, 195, 196, 197, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207,
  64 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 220, 221, 222, 223,
  65 224, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 235, 236, 237, 238, 239,
  66 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 250, 251, 252, 253, 254, 255
  67 };
  68
  69
  70 /* Portable, consistent toupper. Do not use toupper() because its behavior is
  71    altered by the current locale. */
  72 char Curl_raw_toupper(char in)
  73 {
  74   return touppermap[(unsigned char) in];
  75 }
  76
  77
  78 /* Portable, consistent tolower. Do not use tolower() because its behavior is
  79    altered by the current locale. */
  80 char Curl_raw_tolower(char in)
  81 {
  82   return tolowermap[(unsigned char) in];
  83 }
  84
  85 /*
  86  * Curl_strcasecompare() is for doing "raw" case insensitive strings. This is
  87  * meant to be locale independent and only compare strings we know are safe
  88  * for this.  See
  89  * https://daniel.haxx.se/blog/2008/10/15/strcasecmp-in-turkish/ for some
  90  * further explanation to why this function is necessary.
  91  *
  92  * @unittest: 1301
  93  */
  94
  95 int Curl_strcasecompare(const char *first, const char *second)
  96 {
  97   while(*first && *second) {
  98     if(Curl_raw_toupper(*first) != Curl_raw_toupper(*second))
  99       /* get out of the loop as soon as they don't match */
 100       return 0;
 101     first++;
 102     second++;
 103   }
 104   /* If we're here either the strings are the same or the length is different.
 105      We can just test if the "current" character is non-zero for one and zero
 106      for the other. Note that the characters may not be exactly the same even
 107      if they match, we only want to compare zero-ness. */
 108   return !*first == !*second;
 109 }
 110
 111 int Curl_safe_strcasecompare(const char *first, const char *second)
 112 {
 113   if(first && second)
 114     /* both pointers point to something then compare them */
 115     return Curl_strcasecompare(first, second);
 116
 117   /* if both pointers are NULL then treat them as equal */
 118   return (NULL == first && NULL == second);
 119 }
 120
 121 /*
 122  * @unittest: 1301
 123  */
 124 int Curl_strncasecompare(const char *first, const char *second, size_t max)
 125 {
 126   while(*first && *second && max) {
 127     if(Curl_raw_toupper(*first) != Curl_raw_toupper(*second)) {
 128       break;
 129     }
 130     max--;
 131     first++;
 132     second++;
 133   }
 134   if(0 == max)
 135     return 1; /* they are equal this far */
 136
 137   return Curl_raw_toupper(*first) == Curl_raw_toupper(*second);
 138 }
 139
 140 /* Copy an upper case version of the string from src to dest.  The
 141  * strings may overlap.  No more than n characters of the string are copied
 142  * (including any NUL) and the destination string will NOT be
 143  * NUL-terminated if that limit is reached.
 144  */
 145 void Curl_strntoupper(char *dest, const char *src, size_t n)
 146 {
 147   if(n < 1)
 148     return;
 149
 150   do {
 151     *dest++ = Curl_raw_toupper(*src);
 152   } while(*src++ && --n);
 153 }
 154
 155 /* Copy a lower case version of the string from src to dest.  The
 156  * strings may overlap.  No more than n characters of the string are copied
 157  * (including any NUL) and the destination string will NOT be
 158  * NUL-terminated if that limit is reached.
 159  */
 160 void Curl_strntolower(char *dest, const char *src, size_t n)
 161 {
 162   if(n < 1)
 163     return;
 164
 165   do {
 166     *dest++ = Curl_raw_tolower(*src);
 167   } while(*src++ && --n);
 168 }
 169
 170 /* Compare case-sensitive NUL-terminated strings, taking care of possible
 171  * null pointers. Return true if arguments match.
 172  */
 173 bool Curl_safecmp(char *a, char *b)
 174 {
 175   if(a && b)
 176     return !strcmp(a, b);
 177   return !a && !b;
 178 }
 179
 180 /*
 181  * Curl_timestrcmp() returns 0 if the two strings are identical. The time this
 182  * function spends is a function of the shortest string, not of the contents.
 183  */
 184 int Curl_timestrcmp(const char *a, const char *b)
 185 {
 186   int match = 0;
 187   int i = 0;
 188
 189   if(a && b) {
 190     while(1) {
 191       match |= a[i]^b[i];
 192       if(!a[i] || !b[i])
 193         break;
 194       i++;
 195     }
 196   }
 197   else
 198     return a || b;
 199   return match;
 200 }
 201
 202 /* --- public functions --- */
 203
 204 int curl_strequal(const char *first, const char *second)
 205 {
 206   return Curl_strcasecompare(first, second);
 207 }
 208 int curl_strnequal(const char *first, const char *second, size_t max)
 209 {
 210   return Curl_strncasecompare(first, second, max);
 211 }