• Home
  • Features
  • Pricing
  • Docs
  • Announcements
  • Sign In

taosdata / TDengine / #3614

14 Feb 2025 09:14AM UTC coverage: 61.4% (-2.1%) from 63.499%
#3614

push

travis-ci

web-flow
Merge pull request #29781 from taosdata/doc/internal

docs: minor changes

142800 of 298998 branches covered (47.76%)

Branch coverage included in aggregate %.

224842 of 299767 relevant lines covered (75.01%)

17915812.99 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

51.51
/source/os/src/osString.c
1
/*
2
 * Copyright (c) 2019 TAOS Data, Inc. <jhtao@taosdata.com>
3
 *
4
 * This program is free software: you can use, redistribute, and/or modify
5
 * it under the terms of the GNU Affero General Public License, version 3
6
 * or later ("AGPL"), as published by the Free Software Foundation.
7
 *
8
 * This program is distributed in the hope that it will be useful, but WITHOUT
9
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
10
 * FITNESS FOR A PARTICULAR PURPOSE.
11
 *
12
 * You should have received a copy of the GNU Affero General Public License
13
 * along with this program. If not, see <http://www.gnu.org/licenses/>.
14
 */
15

16
#define ALLOW_FORBID_FUNC
17
#define _DEFAULT_SOURCE
18
#include "os.h"
19

20
#ifndef DISALLOW_NCHAR_WITHOUT_ICONV
21
#include "iconv.h"
22
#endif
23

24
extern int wcwidth(wchar_t c);
25
extern int wcswidth(const wchar_t *s, size_t n);
26

27
char *tstrdup(const char *str) {
250,942,136✔
28
  if (str == NULL) {
250,942,136!
29
    terrno = TSDB_CODE_INVALID_PARA;
×
30
    return NULL;
×
31
  }
32
#ifdef WINDOWS
33
  return _strdup(str);
34
#else
35
  char *p = strdup(str);
250,942,136✔
36
  if (NULL == p) {
250,942,136!
37
    terrno = TSDB_CODE_OUT_OF_MEMORY;
×
38
  }
39
  return p;
250,942,136✔
40

41
#endif
42
}
43

44
#ifdef WINDOWS
45

46
// No errors are expected to occur
47
char *strsep(char **stringp, const char *delim) {
48
  if (stringp == NULL) {
49
    terrno = TSDB_CODE_INVALID_PARA;
50
    return NULL;
51
  }
52
  char       *s;
53
  const char *spanp;
54
  int32_t     c, sc;
55
  char       *tok;
56
  if ((s = *stringp) == NULL) return (NULL);
57
  if (delim == NULL) {
58
    terrno = TSDB_CODE_INVALID_PARA;
59
    return NULL;
60
  }
61
  for (tok = s;;) {
62
    c = *s++;
63
    spanp = delim;
64
    do {
65
      if ((sc = *spanp++) == c) {
66
        if (c == 0)
67
          s = NULL;
68
        else
69
          s[-1] = 0;
70
        *stringp = s;
71
        return (tok);
72
      }
73
    } while (sc != 0);
74
  }
75
  /* NOTREACHED */
76
}
77
/* Duplicate a string, up to at most size characters */
78
char *taosStrndupi(const char *s, int64_t size) {
79
  if (s == NULL) return NULL;
80
  size_t l;
81
  char  *s2;
82
  l = strlen(s);
83
  if (l > size) l = size;
84
  s2 = malloc(l + 1);
85
  if (s2) {
86
    tstrncpy(s2, s, l + 1);
87
    s2[l] = '\0';
88
  } else {
89
    terrno = TSDB_CODE_OUT_OF_MEMORY;
90
  }
91
  return s2;
92
}
93
/* Copy no more than N characters of SRC to DEST, returning the address of
94
   the terminating '\0' in DEST, if any, or else DEST + N.  */
95
char *stpncpy(char *dest, const char *src, int n) {
96
  if (dest == NULL || src == NULL) {
97
    terrno = TSDB_CODE_INVALID_PARA;
98
    return NULL;
99
  }
100
  size_t size = strnlen(src, n);
101
  memcpy(dest, src, size);
102
  dest += size;
103
  if (size == n) return dest;
104
  return memset(dest, '\0', n - size);
105
}
106
#else
107
char *taosStrndupi(const char *s, int64_t size) {
514,740,017✔
108
  if (s == NULL) {
514,740,017!
109
    return NULL;
×
110
  }
111
  char *p = strndup(s, size);
514,740,017✔
112
  if (NULL == p) {
514,740,017!
113
    terrno = TSDB_CODE_OUT_OF_MEMORY;
×
114
  }
115
  return p;
514,740,017✔
116
}
117
#endif
118

119
char *tstrndup(const char *str, int64_t size) {
×
120
#ifdef WINDOWS
121
  return taosStrndupi(str, size);
122
#else
123
  char* p = strndup(str, size);
×
124
  if (str != NULL && NULL == p) {
×
125
    terrno = TSDB_CODE_OUT_OF_MEMORY;
×
126
  }
127
  return p;
×
128
  
129
#endif
130
}
131

132

133
int32_t taosStr2int64(const char *str, int64_t *val) {
219,348,568✔
134
  if (str == NULL || val == NULL) {
219,348,568!
135
    return TSDB_CODE_INVALID_PARA;
×
136
  }
137
  errno = 0;
219,406,004✔
138
  char   *endptr = NULL;
219,406,004✔
139
  int64_t ret = strtoll(str, &endptr, 10);
219,406,004✔
140
  if (errno != 0) {
219,737,070!
141
    return TAOS_SYSTEM_ERROR(errno);
×
142
  } else {
143
    if (endptr == str) {
219,737,070✔
144
      return TSDB_CODE_INVALID_PARA;
4✔
145
    }
146
    *val = ret;
219,737,066✔
147
    return 0;
219,737,066✔
148
  }
149
}
150

151
int32_t taosStr2int32(const char *str, int32_t *val) {
219,370,825✔
152
  OS_PARAM_CHECK(str);
219,370,825!
153
  OS_PARAM_CHECK(val);
219,370,825!
154
  int64_t tmp = 0;
219,370,825✔
155
  int32_t code = taosStr2int64(str, &tmp);
219,370,825✔
156
  if (code) {
219,577,579!
157
    return code;
×
158
  } else if (tmp > INT32_MAX || tmp < INT32_MIN) {
219,577,579!
159
    return TAOS_SYSTEM_ERROR(ERANGE);
×
160
  } else {
161
    *val = (int32_t)tmp;
219,580,554✔
162
    return 0;
219,580,554✔
163
  }
164
}
165
int32_t taosStr2int16(const char *str, int16_t *val) {
×
166
  OS_PARAM_CHECK(str);
×
167
  OS_PARAM_CHECK(val);
×
168
  int64_t tmp = 0;
×
169
  int32_t code = taosStr2int64(str, &tmp);
×
170
  if (code) {
×
171
    return code;
×
172
  } else if (tmp > INT16_MAX || tmp < INT16_MIN) {
×
173
    return TAOS_SYSTEM_ERROR(ERANGE);
×
174
  } else {
175
    *val = (int16_t)tmp;
×
176
    return 0;
×
177
  }
178
}
179

180
int32_t taosStr2int8(const char *str, int8_t *val) {
×
181
  OS_PARAM_CHECK(str);
×
182
  OS_PARAM_CHECK(val);
×
183
  int64_t tmp = 0;
×
184
  int32_t code = taosStr2int64(str, &tmp);
×
185
  if (code) {
×
186
    return code;
×
187
  } else if (tmp > INT8_MAX || tmp < INT8_MIN) {
×
188
    return TAOS_SYSTEM_ERROR(ERANGE);
×
189
  } else {
190
    *val = (int8_t)tmp;
×
191
    return 0;
×
192
  }
193
}
194

195
int32_t taosStr2Uint64(const char *str, uint64_t *val) {
×
196
  if (str == NULL || val == NULL) {
×
197
    return TSDB_CODE_INVALID_PARA;
×
198
  }
199
  char *endptr = NULL;
×
200
  errno = 0;
×
201
  uint64_t ret = strtoull(str, &endptr, 10);
×
202

203
  if (errno != 0) {
×
204
    return TAOS_SYSTEM_ERROR(errno);
×
205
  } else {
206
    if (endptr == str) {
×
207
      return TSDB_CODE_INVALID_PARA;
×
208
    }
209
    *val = ret;
×
210
    return 0;
×
211
  }
212
}
213

214
int32_t taosStr2Uint32(const char *str, uint32_t *val) {
×
215
  OS_PARAM_CHECK(str);
×
216
  OS_PARAM_CHECK(val);
×
217
  uint64_t tmp = 0;
×
218
  int32_t  code = taosStr2Uint64(str, &tmp);
×
219
  if (code) {
×
220
    return code;
×
221
  } else if (tmp > UINT32_MAX) {
×
222
    return TAOS_SYSTEM_ERROR(ERANGE);
×
223
  } else {
224
    *val = (int32_t)tmp;
×
225
    return 0;
×
226
  }
227
}
228

229
int32_t taosStr2Uint16(const char *str, uint16_t *val) {
×
230
  OS_PARAM_CHECK(str);
×
231
  OS_PARAM_CHECK(val);
×
232
  uint64_t tmp = 0;
×
233
  int32_t  code = taosStr2Uint64(str, &tmp);
×
234
  if (code) {
×
235
    return code;
×
236
  } else if (tmp > UINT16_MAX) {
×
237
    return TAOS_SYSTEM_ERROR(ERANGE);
×
238
  } else {
239
    *val = (int16_t)tmp;
×
240
    return 0;
×
241
  }
242
}
243

244
int32_t taosStr2Uint8(const char *str, uint8_t *val) {
×
245
  OS_PARAM_CHECK(str);
×
246
  OS_PARAM_CHECK(val);
×
247
  uint64_t tmp = 0;
×
248
  int32_t  code = taosStr2Uint64(str, &tmp);
×
249
  if (code) {
×
250
    return code;
×
251
  } else if (tmp > UINT8_MAX) {
×
252
    return TAOS_SYSTEM_ERROR(ERANGE);
×
253
  } else {
254
    *val = (int8_t)tmp;
×
255
    return 0;
×
256
  }
257
}
258

259
int32_t tasoUcs4Compare(TdUcs4 *f1_ucs4, TdUcs4 *f2_ucs4, int32_t bytes) {
122,450,177✔
260
  if ((f1_ucs4 == NULL || f2_ucs4 == NULL)) {
122,450,177!
261
    return TSDB_CODE_INVALID_PARA;
×
262
  }
263
  for (int32_t i = 0; i < bytes; i += sizeof(TdUcs4)) {
644,869,976✔
264
    int32_t f1 = *(int32_t *)((char *)f1_ucs4 + i);
586,441,858✔
265
    int32_t f2 = *(int32_t *)((char *)f2_ucs4 + i);
586,441,858✔
266

267
    if ((f1 == 0 && f2 != 0) || (f1 != 0 && f2 == 0)) {
586,441,858!
268
      return f1 - f2;
×
269
    } else if (f1 == 0 && f2 == 0) {
586,441,858!
270
      return 0;
×
271
    }
272

273
    if (f1 != f2) {
586,441,858✔
274
      return f1 - f2;
64,118,619✔
275
    }
276
  }
277

278
  return 0;
58,428,118✔
279

280
  //#if 0
281
  //  int32_t ucs4_max_len = bytes + 4;
282
  //  char *f1_mbs = taosMemoryCalloc(bytes, 1);
283
  //  char *f2_mbs = taosMemoryCalloc(bytes, 1);
284
  //  if (taosUcs4ToMbs(f1_ucs4, ucs4_max_len, f1_mbs) < 0) {
285
  //    return -1;
286
  //  }
287
  //  if (taosUcs4ToMbs(f2_ucs4, ucs4_max_len, f2_mbs) < 0) {
288
  //    return -1;
289
  //  }
290
  //  int32_t ret = strcmp(f1_mbs, f2_mbs);
291
  //  taosMemoryFree(f1_mbs);
292
  //  taosMemoryFree(f2_mbs);
293
  //  return ret;
294
  //#endif
295
}
296

297
int32_t tasoUcs4Copy(TdUcs4 *target_ucs4, TdUcs4 *source_ucs4, int32_t len_ucs4) {
×
298
  if (target_ucs4 == NULL || source_ucs4 == NULL || len_ucs4 <= 0) {
×
299
    return TSDB_CODE_INVALID_PARA;
×
300
  }
301
  if (taosMemorySize(target_ucs4) < len_ucs4 * sizeof(TdUcs4)) {
×
302
    terrno = TSDB_CODE_INVALID_PARA;
×
303
    return terrno;
×
304
  }
305

306
  (void)memcpy(target_ucs4, source_ucs4, len_ucs4 * sizeof(TdUcs4));
×
307

308
  return TSDB_CODE_SUCCESS;
×
309
}
310

311
iconv_t taosAcquireConv(int32_t *idx, ConvType type, void* charsetCxt) {
233,222,500✔
312
  if(idx == NULL) {
233,222,500!
313
    terrno = TSDB_CODE_INVALID_PARA;
×
314
    return (iconv_t)-1;
×
315
  }
316
  if (charsetCxt == NULL){
233,222,500!
317
    charsetCxt = tsCharsetCxt;
233,243,520✔
318
  }
319
  SConvInfo *info = (SConvInfo *)charsetCxt;
233,222,500✔
320
  if (info == NULL) {
233,222,500!
321
    *idx = -1;
×
322
    if (type == M2C) {
×
323
      iconv_t c = iconv_open(DEFAULT_UNICODE_ENCODEC, "UTF-8");
×
324
      if ((iconv_t)-1 == c) {
×
325
        terrno = TAOS_SYSTEM_ERROR(errno);
×
326
      }
327
      return c;
×
328
    } else {
329
      iconv_t c = iconv_open("UTF-8", DEFAULT_UNICODE_ENCODEC);
×
330
      if ((iconv_t)-1 == c) {
×
331
        terrno = TAOS_SYSTEM_ERROR(errno);
×
332
      }
333
      return c;
×
334
    }
335
  }
336

337
  while (true) {
×
338
    int32_t used = atomic_add_fetch_32(&info->convUsed[type], 1);
233,222,500✔
339
    if (used > info->gConvMaxNum[type]) {
233,595,674!
340
      (void)atomic_sub_fetch_32(&info->convUsed[type], 1);
×
341
      (void)sched_yield();
×
342
      continue;
×
343
    }
344

345
    break;
233,688,890✔
346
  }
347

348
  int32_t startId = taosGetSelfPthreadId() % info->gConvMaxNum[type];
233,688,890✔
349
  while (true) {
65,193✔
350
    if (info->gConv[type][startId].inUse) {
233,669,061✔
351
      startId = (startId + 1) % info->gConvMaxNum[type];
42,957✔
352
      continue;
42,957✔
353
    }
354

355
    int8_t old = atomic_val_compare_exchange_8(&info->gConv[type][startId].inUse, 0, 1);
233,626,104✔
356
    if (0 == old) {
233,782,048✔
357
      break;
233,759,812✔
358
    }
359
  }
360

361
  *idx = startId;
233,759,812✔
362
  if ((iconv_t)0 == info->gConv[type][startId].conv) {
233,759,812!
363
    return (iconv_t)-1;
×
364
  } else {
365
    return info->gConv[type][startId].conv;
233,759,812✔
366
  }
367
}
368

369
void taosReleaseConv(int32_t idx, iconv_t conv, ConvType type, void* charsetCxt) {
233,519,747✔
370
  if (idx < 0) {
233,519,747!
371
    (void)iconv_close(conv);
×
372
    return;
×
373
  }
374

375
  if (charsetCxt == NULL){
233,519,747!
376
    charsetCxt = tsCharsetCxt;
233,531,507✔
377
  }
378
  SConvInfo *info = (SConvInfo *)charsetCxt;
233,519,747✔
379

380
  atomic_store_8(&info->gConv[type][idx].inUse, 0);
233,519,747✔
381
  (void)atomic_sub_fetch_32(&info->convUsed[type], 1);
233,711,034✔
382
}
383

384
bool taosMbsToUcs4(const char *mbs, size_t mbsLength, TdUcs4 *ucs4, int32_t ucs4_max_len, int32_t *len, void* charsetCxt) {
99,815,274✔
385
  if (ucs4_max_len == 0) {
99,815,274✔
386
    return true;
691,482✔
387
  }
388
  if (ucs4_max_len < 0 || mbs == NULL || ucs4 == NULL) {
99,123,792!
389
    terrno = TSDB_CODE_INVALID_PARA;
6,507✔
390
    return false;
×
391
  }
392
#ifdef DISALLOW_NCHAR_WITHOUT_ICONV
393
  printf("Nchar cannot be read and written without iconv, please install iconv library and recompile.\n");
394
  terrno = TSDB_CODE_APP_ERROR;
395
  return false;
396
#else
397
  (void)memset(ucs4, 0, ucs4_max_len);
99,117,285✔
398

399
  int32_t idx = -1;
99,117,285✔
400
  iconv_t conv = taosAcquireConv(&idx, M2C, charsetCxt);
99,117,285✔
401
  if ((iconv_t)-1 == conv) {
99,555,613!
402
    return false;
×
403
  }
404

405
  size_t ucs4_input_len = mbsLength;
99,555,613✔
406
  size_t outLeft = ucs4_max_len;
99,555,613✔
407
  if (iconv(conv, (char **)&mbs, &ucs4_input_len, (char **)&ucs4, &outLeft) == -1) {
99,555,613✔
408
    terrno = TAOS_SYSTEM_ERROR(errno);
247✔
409
    taosReleaseConv(idx, conv, M2C, charsetCxt);
247✔
410
    return false;
3,120✔
411
  }
412

413
  taosReleaseConv(idx, conv, M2C, charsetCxt);
99,580,623✔
414
  if (len != NULL) {
99,664,185!
415
    *len = (int32_t)(ucs4_max_len - outLeft);
99,664,362✔
416
    if (*len < 0) {
99,664,362!
417
      // can not happen
418
      terrno = TSDB_CODE_APP_ERROR;
×
419
      return false;
×
420
    }
421
  }
422

423
  return true;
99,664,185✔
424
#endif
425
}
426

427
// if success, return the number of bytes written to mbs ( >= 0)
428
// otherwise return error code ( < 0)
429
int32_t taosUcs4ToMbs(TdUcs4 *ucs4, int32_t ucs4_max_len, char *mbs, void* charsetCxt) {
132,793,046✔
430
  if (ucs4_max_len == 0) {
132,793,046✔
431
    return 0;
136✔
432
  }
433
  if (ucs4_max_len < 0 || ucs4 == NULL || mbs == NULL) {
132,792,910!
434
    terrno = TSDB_CODE_INVALID_PARA;
7,094✔
435
    return terrno;
×
436
  }
437
#ifdef DISALLOW_NCHAR_WITHOUT_ICONV
438
  printf("Nchar cannot be read and written without iconv, please install iconv library and recompile.\n");
439
  terrno = TSDB_CODE_APP_ERROR;
440
  return terrno;
441
#else
442

443
  int32_t idx = -1;
132,785,816✔
444
  int32_t code = 0;
132,785,816✔
445
  iconv_t conv = taosAcquireConv(&idx, C2M, charsetCxt);
132,785,816✔
446
  if ((iconv_t)-1 == conv) {
132,840,015!
447
    return terrno;
×
448
  }
449

450
  size_t ucs4_input_len = ucs4_max_len;
132,840,015✔
451
  size_t outLen = ucs4_max_len;
132,840,015✔
452
  if (iconv(conv, (char **)&ucs4, &ucs4_input_len, &mbs, &outLen) == -1) {
132,840,015!
453
    code = TAOS_SYSTEM_ERROR(errno);
×
454
    taosReleaseConv(idx, conv, C2M, charsetCxt);
×
455
    terrno = code;
×
456
    return code;
867✔
457
  }
458

459
  taosReleaseConv(idx, conv, C2M, charsetCxt);
132,845,440✔
460

461
  return (int32_t)(ucs4_max_len - outLen);
132,864,432✔
462
#endif
463
}
464

465
// if success, return the number of bytes written to mbs ( >= 0)
466
// otherwise return error code ( < 0)
467
int32_t taosUcs4ToMbsEx(TdUcs4 *ucs4, int32_t ucs4_max_len, char *mbs, iconv_t conv) {
24,694,029✔
468
  if (ucs4_max_len == 0) {
24,694,029✔
469
    return 0;
131,261✔
470
  }
471
  if (ucs4_max_len < 0 || ucs4 == NULL || mbs == NULL) {
24,562,768!
472
    terrno = TSDB_CODE_INVALID_PARA;
470✔
473
    return terrno;
×
474
  }
475
#ifdef DISALLOW_NCHAR_WITHOUT_ICONV
476
  printf("Nchar cannot be read and written without iconv, please install iconv library and recompile.\n");
477
  terrno = TSDB_CODE_APP_ERROR;
478
  return terrno;
479
#else
480

481
  size_t ucs4_input_len = ucs4_max_len;
24,562,298✔
482
  size_t outLen = ucs4_max_len;
24,562,298✔
483
  if (iconv(conv, (char **)&ucs4, &ucs4_input_len, &mbs, &outLen) == -1) {
24,562,298!
484
    terrno = TAOS_SYSTEM_ERROR(errno);
×
485
    return terrno;
×
486
  }
487

488
  return (int32_t)(ucs4_max_len - outLen);
24,563,146✔
489
#endif
490
}
491

492
bool taosValidateEncodec(const char *encodec) {
5,756✔
493
  if (encodec == NULL) {
5,756!
494
    terrno = TSDB_CODE_INVALID_PARA;
×
495
    return false;
×
496
  }
497
#ifdef DISALLOW_NCHAR_WITHOUT_ICONV
498
  printf("Nchar cannot be read and written without iconv, please install iconv library and recompile.\n");
499
  terrno = TSDB_CODE_APP_ERROR;
500
  return false;
501
#else
502
  iconv_t cd = iconv_open(encodec, DEFAULT_UNICODE_ENCODEC);
5,756✔
503
  if (cd == (iconv_t)(-1)) {
5,756!
504
    terrno = TAOS_SYSTEM_ERROR(errno);
×
505
    return false;
×
506
  }
507

508
  (void)iconv_close(cd);
5,756✔
509
  return true;
5,756✔
510
#endif
511
}
512

513
int32_t taosUcs4len(TdUcs4 *ucs4) {
×
514
  TdUcs4 *wstr = (TdUcs4 *)ucs4;
×
515
  if (NULL == wstr) {
×
516
    return 0;
×
517
  }
518

519
  int32_t n = 0;
×
520
  while (1) {
521
    if (0 == *wstr++) {
×
522
      break;
×
523
    }
524
    n++;
×
525
  }
526

527
  return n;
×
528
}
529

530
// dst buffer size should be at least 2*len + 1
531
int32_t taosHexEncode(const unsigned char *src, char *dst, int32_t len, int32_t bufSize) {
×
532
  if (!dst || !src || bufSize <= 0) {
×
533
    terrno = TSDB_CODE_INVALID_PARA;
×
534
    return terrno;
×
535
  }
536

537
  for (int32_t i = 0; i < len; ++i) {
×
538
    (void)snprintf(dst + i * 2, bufSize - i * 2, "%02x", src[i]);
×
539
  }
540

541
  return 0;
×
542
}
543

544
int32_t taosHexDecode(const char *src, char *dst, int32_t len) {
×
545
  if (!src || !dst || len <= 0) {
×
546
    terrno = TSDB_CODE_INVALID_PARA;
×
547
    return terrno;
×
548
  }
549

550
  uint8_t hn, ln, out;
551
  for (int i = 0, j = 0; i < len * 2; i += 2, ++j) {
×
552
    hn = src[i] > '9' ? src[i] - 'a' + 10 : src[i] - '0';
×
553
    ln = src[i + 1] > '9' ? src[i + 1] - 'a' + 10 : src[i + 1] - '0';
×
554

555
    out = (hn << 4) | ln;
×
556
    (void)memcpy(dst + j, &out, 1);
×
557
  }
558

559
  return 0;
×
560
}
561

562
int32_t taosWcharWidth(TdWchar wchar) { return wcwidth(wchar); }
41,435,269✔
563

564
int32_t taosWcharsWidth(TdWchar *pWchar, int32_t size) {
×
565
  if (pWchar == NULL || size <= 0) {
×
566
    terrno = TSDB_CODE_INVALID_PARA;
×
567
    return terrno;
×
568
  }
569
  return wcswidth(pWchar, size);
×
570
}
571

572
int32_t taosMbToWchar(TdWchar *pWchar, const char *pStr, int32_t size) {
41,435,176✔
573
  if (pWchar == NULL || pStr == NULL || size <= 0) {
41,435,176!
574
    terrno = TSDB_CODE_INVALID_PARA;
×
575
    return terrno;
×
576
  }
577
  return mbtowc(pWchar, pStr, size);
41,435,176✔
578
}
579

580
int32_t taosMbsToWchars(TdWchar *pWchars, const char *pStrs, int32_t size) {
×
581
  if (pWchars == NULL || pStrs == NULL || size <= 0) {
×
582
    terrno = TSDB_CODE_INVALID_PARA;
×
583
    return terrno;
×
584
  }
585
  return mbstowcs(pWchars, pStrs, size);
×
586
}
587

588
int32_t taosWcharToMb(char *pStr, TdWchar wchar) {
×
589
  OS_PARAM_CHECK(pStr);
×
590
  return wctomb(pStr, wchar);
×
591
}
592

593
char *taosStrCaseStr(const char *str, const char *pattern) {
6✔
594
  if (str == NULL) {
6!
595
    terrno = TSDB_CODE_INVALID_PARA;
×
596
    return NULL;
×
597
  }
598
  if (!pattern || !*pattern) return (char *)str;
6!
599

600
  size_t i;
601
  for (; *str; str++) {
180✔
602
    if (toupper(*str) == toupper(*pattern)) {
174✔
603
      for (i = 1;; i++) {
24✔
604
        if (!pattern[i]) return (char *)str;
24!
605
        if (toupper(str[i]) != toupper(pattern[i])) break;
24!
606
      }
607
    }
608
  }
609
  return NULL;
6✔
610
}
611

612
int64_t taosStr2Int64(const char *str, char **pEnd, int32_t radix) {
2,147,483,647✔
613
  if (str == NULL) {
2,147,483,647!
614
    terrno = TSDB_CODE_INVALID_PARA;
×
615
    return 0;
×
616
  }
617
  int64_t tmp = strtoll(str, pEnd, radix);
2,147,483,647✔
618
#if defined(DARWIN) || defined(_ALPINE)
619
  if (errno == EINVAL) errno = 0;
620
#endif
621
  return tmp;
2,147,483,647✔
622
}
623

624
uint64_t taosStr2UInt64(const char *str, char **pEnd, int32_t radix) {
220,855,162✔
625
  if (str == NULL) {
220,855,162!
626
    terrno = TSDB_CODE_INVALID_PARA;
×
627
    return 0;
×
628
  }
629
  uint64_t tmp = strtoull(str, pEnd, radix);
220,855,162✔
630
#if defined(DARWIN) || defined(_ALPINE)
631
  if (errno == EINVAL) errno = 0;
632
#endif
633
  return tmp;
224,176,592✔
634
}
635

636
int32_t taosStr2Int32(const char *str, char **pEnd, int32_t radix) {
15,286,384✔
637
  if (str == NULL) {
15,286,384!
638
    terrno = TSDB_CODE_INVALID_PARA;
×
639
    return 0;
×
640
  }
641
  int32_t tmp = strtol(str, pEnd, radix);
15,286,384✔
642
#if defined(DARWIN) || defined(_ALPINE)
643
  if (errno == EINVAL) errno = 0;
644
#endif
645
  return tmp;
15,287,647✔
646
}
647

648
uint32_t taosStr2UInt32(const char *str, char **pEnd, int32_t radix) {
6,263✔
649
  if (str == NULL) {
6,263!
650
    terrno = TSDB_CODE_INVALID_PARA;
×
651
    return 0;
×
652
  }
653
  uint32_t tmp = strtol(str, pEnd, radix);
6,263✔
654
#if defined(DARWIN) || defined(_ALPINE)
655
  if (errno == EINVAL) errno = 0;
656
#endif
657
  return tmp;
6,263✔
658
}
659

660
int16_t taosStr2Int16(const char *str, char **pEnd, int32_t radix) {
13,265✔
661
  if (str == NULL) {
13,265!
662
    terrno = TSDB_CODE_INVALID_PARA;
×
663
    return 0;
×
664
  }
665
  int32_t tmp = strtol(str, pEnd, radix);
13,265✔
666
#if defined(DARWIN) || defined(_ALPINE)
667
  if (errno == EINVAL) errno = 0;
668
#endif
669
  return (int16_t)tmp;
13,265✔
670
}
671

672
uint16_t taosStr2UInt16(const char *str, char **pEnd, int32_t radix) {
38,695✔
673
  if (str == NULL) {
38,695!
674
    terrno = TSDB_CODE_INVALID_PARA;
×
675
    return 0;
×
676
  }
677
  uint32_t tmp = strtoul(str, pEnd, radix);
38,695✔
678
#if defined(DARWIN) || defined(_ALPINE)
679
  if (errno == EINVAL) errno = 0;
680
#endif
681
  return (uint16_t)tmp;
38,699✔
682
}
683

684
int8_t taosStr2Int8(const char *str, char **pEnd, int32_t radix) {
33,011✔
685
  if (str == NULL) {
33,011!
686
    terrno = TSDB_CODE_INVALID_PARA;
×
687
    return 0;
×
688
  }
689
  int32_t tmp = strtol(str, pEnd, radix);
33,011✔
690
  return tmp;
33,011✔
691
}
692

693
uint8_t taosStr2UInt8(const char *str, char **pEnd, int32_t radix) {
6,673✔
694
  if (str == NULL) {
6,673!
695
    terrno = TSDB_CODE_INVALID_PARA;
×
696
    return 0;
×
697
  }
698
  uint32_t tmp = strtoul(str, pEnd, radix);
6,673✔
699
#if defined(DARWIN) || defined(_ALPINE)
700
  if (errno == EINVAL) errno = 0;
701
#endif
702
  return tmp;
6,673✔
703
}
704

705
double taosStr2Double(const char *str, char **pEnd) {
1,081,986,128✔
706
  if (str == NULL) {
1,081,986,128!
707
    terrno = TSDB_CODE_INVALID_PARA;
×
708
    return 0;
×
709
  }
710
  double tmp = strtod(str, pEnd);
1,081,986,128✔
711
  return tmp;
1,085,953,025✔
712
}
713

714
float taosStr2Float(const char *str, char **pEnd) {
32,231✔
715
  if (str == NULL) {
32,231!
716
    terrno = TSDB_CODE_INVALID_PARA;
×
717
    return 0;
×
718
  }
719
  float tmp = strtof(str, pEnd);
32,231✔
720
  return tmp;
32,231✔
721
}
722

723
#define HEX_PREFIX_LEN 2  // \x
724
bool isHex(const char *z, uint32_t n) {
658,902✔
725
  if (n < HEX_PREFIX_LEN) return false;
658,902✔
726
  if (z[0] == '\\' && z[1] == 'x') return true;
558,892✔
727
  return false;
554,040✔
728
}
729

730
bool isValidateHex(const char *z, uint32_t n) {
4,852✔
731
  if (!z) {
4,852!
732
    terrno = TSDB_CODE_INVALID_PARA;
×
733
    return false;
×
734
  }
735
  if ((n & 1) != 0) return false;
4,852✔
736
  for (size_t i = HEX_PREFIX_LEN; i < n; i++) {
629,132,075✔
737
    if (isxdigit(z[i]) == 0) {
629,127,226!
738
      return false;
×
739
    }
740
  }
741
  return true;
4,849✔
742
}
743

744
int32_t taosHex2Ascii(const char *z, uint32_t n, void **data, uint32_t *size) {
4,849✔
745
  OS_PARAM_CHECK(z);
4,849!
746
  OS_PARAM_CHECK(data);
4,849!
747
  OS_PARAM_CHECK(size);
4,849!
748
  n -= HEX_PREFIX_LEN;  // remove 0x
4,849✔
749
  z += HEX_PREFIX_LEN;
4,849✔
750
  *size = n / HEX_PREFIX_LEN;
4,849✔
751
  if (*size == 0) {
4,849✔
752
    if (!(*data = taosStrdup(""))) {
7!
753
      return terrno;
×
754
    }
755
    return 0;
7✔
756
  }
757

758
  uint8_t *tmp = (uint8_t *)taosMemoryCalloc(*size, 1);
4,842!
759
  if (tmp == NULL) {
4,842!
760
    return terrno;
×
761
  }
762

763
  int8_t   num = 0;
4,842✔
764
  uint8_t *byte = tmp + *size - 1;
4,842✔
765

766
  for (int i = n - 1; i >= 0; i--) {
629,132,068✔
767
    if (z[i] >= 'a') {
629,127,226✔
768
      *byte |= ((uint8_t)(10 + (z[i] - 'a')) << (num * 4));
314,498,011✔
769
    } else if (z[i] >= 'A') {
314,629,215✔
770
      *byte |= ((uint8_t)(10 + (z[i] - 'A')) << (num * 4));
18✔
771
    } else {
772
      *byte |= ((uint8_t)(z[i] - '0') << (num * 4));
314,629,197✔
773
    }
774
    if (num == 1) {
629,127,226✔
775
      byte--;
314,563,613✔
776
      num = 0;
314,563,613✔
777
    } else {
778
      num++;
314,563,613✔
779
    }
780
  }
781
  *data = tmp;
4,842✔
782

783
  return 0;
4,842✔
784
}
785

786
// int32_t taosBin2Ascii(const char *z, uint32_t n, void** data, uint32_t* size){
787
//
788
//   for (i = 2; isdigit(z[i]) || (z[i] >= 'a' && z[i] <= 'f') || (z[i] >= 'A' && z[i] <= 'F'); ++i) {
789
//   }
790
//
791
//   n -= 2;   // remove 0b
792
//   z += 2;
793
//   *size = n%8 == 0 ? n/8 : n/8 + 1;
794
//   uint8_t* tmp = (uint8_t*)taosMemoryCalloc(*size, 1);
795
//   if(tmp == NULL) return -1;
796
//   int8_t   num = 0;
797
//   uint8_t *byte = tmp + *size - 1;
798
//
799
//   for (int i = n - 1; i >= 0; i--) {
800
//     *byte |= ((uint8_t)(z[i] - '0') << num);
801
//     if (num == 7) {
802
//       byte--;
803
//       num = 0;
804
//     } else {
805
//       num++;
806
//     }
807
//   }
808
//   *data = tmp;
809
//   return 0;
810
// }
811

812
static char valueOf(uint8_t symbol) {
2,401,462✔
813
  switch (symbol) {
2,401,462✔
814
    case 0:
175,407✔
815
      return '0';
175,407✔
816
    case 1:
66,512✔
817
      return '1';
66,512✔
818
    case 2:
93,134✔
819
      return '2';
93,134✔
820
    case 3:
84,214✔
821
      return '3';
84,214✔
822
    case 4:
71,276✔
823
      return '4';
71,276✔
824
    case 5:
62,277✔
825
      return '5';
62,277✔
826
    case 6:
753,511✔
827
      return '6';
753,511✔
828
    case 7:
580,601✔
829
      return '7';
580,601✔
830
    case 8:
97,520✔
831
      return '8';
97,520✔
832
    case 9:
84,218✔
833
      return '9';
84,218✔
834
    case 10:
106,380✔
835
      return 'A';
106,380✔
836
    case 11:
70,924✔
837
      return 'B';
70,924✔
838
    case 12:
44,555✔
839
      return 'C';
44,555✔
840
    case 13:
48,753✔
841
      return 'D';
48,753✔
842
    case 14:
35,573✔
843
      return 'E';
35,573✔
844
    case 15:
26,601✔
845
      return 'F';
26,601✔
846
    default: {
6✔
847
      return -1;
6✔
848
    }
849
  }
850
}
851

852
int32_t taosAscii2Hex(const char *z, uint32_t n, void **data, uint32_t *size) {
4,681✔
853
  *size = n * 2 + HEX_PREFIX_LEN;
4,681✔
854
  uint8_t *tmp = (uint8_t *)taosMemoryCalloc(*size + 1, 1);
4,681!
855
  if (tmp == NULL) {
4,681!
856
    return terrno;
×
857
  }
858

859
  *data = tmp;
4,681✔
860
  *(tmp++) = '\\';
4,681✔
861
  *(tmp++) = 'x';
4,681✔
862
  for (int i = 0; i < n; i++) {
1,205,412✔
863
    uint8_t val = z[i];
1,200,731✔
864
    tmp[i * 2] = valueOf(val >> 4);
1,200,731✔
865
    tmp[i * 2 + 1] = valueOf(val & 0x0F);
1,200,731✔
866
  }
867

868
  return 0;
4,681✔
869
}
870

871
int64_t tsnprintf(char *dst, int64_t size, const char *format, ...) {
760,654,062✔
872
  if (dst == NULL || format == NULL) {
760,654,062!
873
    terrno = TSDB_CODE_INVALID_PARA;
×
874
    return 0;
×
875
  }
876
  if (size <= 0) return 0;
778,662,867!
877
  if (size == 1) {
778,662,867!
878
    dst[0] = '\0';
×
879
    return 0;
×
880
  }
881
  if (size > SIZE_MAX) {
882
    size = SIZE_MAX;
883
  }
884

885
  int64_t ret;
886
  va_list args;
887
  va_start(args, format);
778,662,867✔
888
  ret = vsnprintf(dst, size, format, args);
778,662,867✔
889
  va_end(args);
778,662,867✔
890
  if (ret >= size) {
778,662,867!
891
    return size - 1;
×
892
  } else {
893
    return ret;
778,662,867✔
894
  }
895
}
STATUS · Troubleshooting · Open an Issue · Sales · Support · CAREERS · ENTERPRISE · START FREE · SCHEDULE DEMO
ANNOUNCEMENTS · TWITTER · TOS & SLA · Supported CI Services · What's a CI service? · Automated Testing

© 2026 Coveralls, Inc