Coverage Report

Created: 2026-09-14 07:07

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/curl/lib/uint-table.c
Line
Count
Source
1
/***************************************************************************
2
 *                                  _   _ ____  _
3
 *  Project                     ___| | | |  _ \| |
4
 *                             / __| | | | |_) | |
5
 *                            | (__| |_| |  _ <| |___
6
 *                             \___|\___/|_| \_\_____|
7
 *
8
 * Copyright (C) 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
#include "curl_setup.h"
25
26
#include "uint-table.h"
27
28
#ifdef DEBUGBUILD
29
12.4k
#define CURL_UINT32_TBL_MAGIC  0x62757473
30
#endif
31
32
void Curl_uint32_tbl_init(struct uint32_tbl *tbl)
33
12.4k
{
34
12.4k
  memset(tbl, 0, sizeof(*tbl));
35
12.4k
  tbl->last_key_added = UINT32_MAX;
36
12.4k
#ifdef DEBUGBUILD
37
12.4k
  tbl->init = CURL_UINT32_TBL_MAGIC;
38
12.4k
#endif
39
12.4k
}
40
41
static void uint32_tbl_clear_rows(struct uint32_tbl *tbl,
42
                                  uint32_t from,
43
                                  uint32_t upto_excluding)
44
37.3k
{
45
37.3k
  uint32_t i, end;
46
47
37.3k
  end = CURLMIN(upto_excluding, tbl->nrows);
48
1.65M
  for(i = from; i < end; ++i) {
49
1.61M
    if(tbl->rows[i]) {
50
24.8k
      tbl->rows[i] = NULL;
51
24.8k
      tbl->nentries--;
52
24.8k
    }
53
1.61M
  }
54
37.3k
}
55
56
CURLcode Curl_uint32_tbl_resize(struct uint32_tbl *tbl, uint32_t nrows)
57
12.4k
{
58
  /* we use `tbl->nrows + 1` during iteration, want that to work */
59
12.4k
  DEBUGASSERT(tbl->init == CURL_UINT32_TBL_MAGIC);
60
12.4k
  if(!nrows)
61
0
    return CURLE_BAD_FUNCTION_ARGUMENT;
62
12.4k
  if(nrows != tbl->nrows) {
63
12.4k
    void **rows = curlx_calloc(nrows, sizeof(void *));
64
12.4k
    if(!rows)
65
0
      return CURLE_OUT_OF_MEMORY;
66
12.4k
    if(tbl->rows) {
67
0
      memcpy(rows, tbl->rows, (CURLMIN(nrows, tbl->nrows) * sizeof(void *)));
68
0
      if(nrows < tbl->nrows)
69
0
        uint32_tbl_clear_rows(tbl, nrows, tbl->nrows);
70
0
      curlx_free(tbl->rows);
71
0
    }
72
12.4k
    tbl->rows = rows;
73
12.4k
    tbl->nrows = nrows;
74
12.4k
  }
75
12.4k
  return CURLE_OK;
76
12.4k
}
77
78
/* Clear the table, making it empty.
79
80
   @unittest 3212
81
 */
82
UNITTEST void uint32_tbl_clear(struct uint32_tbl *tbl);
83
UNITTEST void uint32_tbl_clear(struct uint32_tbl *tbl)
84
12.4k
{
85
12.4k
  DEBUGASSERT(tbl->init == CURL_UINT32_TBL_MAGIC);
86
12.4k
  uint32_tbl_clear_rows(tbl, 0, tbl->nrows);
87
12.4k
  DEBUGASSERT(!tbl->nentries);
88
12.4k
  tbl->last_key_added = UINT32_MAX;
89
12.4k
}
90
91
void Curl_uint32_tbl_destroy(struct uint32_tbl *tbl)
92
12.4k
{
93
12.4k
  DEBUGASSERT(tbl->init == CURL_UINT32_TBL_MAGIC);
94
12.4k
  uint32_tbl_clear(tbl);
95
12.4k
  curlx_free(tbl->rows);
96
12.4k
  memset(tbl, 0, sizeof(*tbl));
97
12.4k
}
98
99
uint32_t Curl_uint32_tbl_capacity(struct uint32_tbl *tbl)
100
12.4k
{
101
12.4k
  return tbl->nrows;
102
12.4k
}
103
104
uint32_t Curl_uint32_tbl_count(struct uint32_tbl *tbl)
105
24.8k
{
106
24.8k
  return tbl->nentries;
107
24.8k
}
108
109
void *Curl_uint32_tbl_get(struct uint32_tbl *tbl, uint32_t key)
110
41.0k
{
111
41.0k
  return (key < tbl->nrows) ? tbl->rows[key] : NULL;
112
41.0k
}
113
114
bool Curl_uint32_tbl_add(struct uint32_tbl *tbl, void *entry, uint32_t *pkey)
115
24.8k
{
116
24.8k
  uint32_t key, start_pos;
117
118
24.8k
  DEBUGASSERT(tbl->init == CURL_UINT32_TBL_MAGIC);
119
24.8k
  if(!entry || !pkey)
120
0
    return FALSE;
121
24.8k
  *pkey = UINT32_MAX;
122
24.8k
  if(tbl->nentries == tbl->nrows)  /* full */
123
0
    return FALSE;
124
125
24.8k
  start_pos = CURLMIN(tbl->last_key_added, tbl->nrows) + 1;
126
24.8k
  for(key = start_pos; key < tbl->nrows; ++key) {
127
12.4k
    if(!tbl->rows[key]) {
128
12.4k
      tbl->rows[key] = entry;
129
12.4k
      tbl->nentries++;
130
12.4k
      tbl->last_key_added = key;
131
12.4k
      *pkey = key;
132
12.4k
      return TRUE;
133
12.4k
    }
134
12.4k
  }
135
  /* no free entry at or above tbl->maybe_next_key, wrap around */
136
12.4k
  for(key = 0; key < start_pos; ++key) {
137
12.4k
    if(!tbl->rows[key]) {
138
12.4k
      tbl->rows[key] = entry;
139
12.4k
      tbl->nentries++;
140
12.4k
      tbl->last_key_added = key;
141
12.4k
      *pkey = key;
142
12.4k
      return TRUE;
143
12.4k
    }
144
12.4k
  }
145
  /* Did not find any free row? Should not happen */
146
0
  DEBUGASSERT(0);
147
0
  return FALSE;
148
0
}
149
150
void Curl_uint32_tbl_remove(struct uint32_tbl *tbl, uint32_t key)
151
24.8k
{
152
24.8k
  uint32_tbl_clear_rows(tbl, key, key + 1);
153
24.8k
}
154
155
bool Curl_uint32_tbl_contains(struct uint32_tbl *tbl, uint32_t key)
156
12.4k
{
157
12.4k
  return (key < tbl->nrows) ? !!tbl->rows[key] : FALSE;
158
12.4k
}
159
160
static bool uint32_tbl_next_at(struct uint32_tbl *tbl, uint32_t key,
161
                               uint32_t *pkey, void **pentry)
162
24.8k
{
163
1.60M
  for(; key < tbl->nrows; ++key) {
164
1.59M
    if(tbl->rows[key]) {
165
12.4k
      *pkey = key;
166
12.4k
      *pentry = tbl->rows[key];
167
12.4k
      return TRUE;
168
12.4k
    }
169
1.59M
  }
170
12.4k
  *pkey = UINT32_MAX;  /* always invalid */
171
12.4k
  *pentry = NULL;
172
12.4k
  return FALSE;
173
24.8k
}
174
175
bool Curl_uint32_tbl_first(struct uint32_tbl *tbl,
176
                           uint32_t *pkey, void **pentry)
177
12.4k
{
178
12.4k
  if(!pkey || !pentry)
179
0
    return FALSE;
180
12.4k
  if(tbl->nentries && uint32_tbl_next_at(tbl, 0, pkey, pentry))
181
12.4k
    return TRUE;
182
0
  DEBUGASSERT(!tbl->nentries);
183
0
  *pkey = UINT32_MAX;  /* always invalid */
184
0
  *pentry = NULL;
185
0
  return FALSE;
186
0
}
187
188
bool Curl_uint32_tbl_next(struct uint32_tbl *tbl, uint32_t last_key,
189
                          uint32_t *pkey, void **pentry)
190
12.4k
{
191
12.4k
  if(!pkey || !pentry)
192
0
    return FALSE;
193
12.4k
  if(uint32_tbl_next_at(tbl, last_key + 1, pkey, pentry))
194
0
    return TRUE;
195
12.4k
  *pkey = UINT32_MAX;  /* always invalid */
196
12.4k
  *pentry = NULL;
197
  return FALSE;
198
12.4k
}