rapidyaml  0.10.0
parse and emit YAML, and do it fast
Functions
from_chars_first: generalized chars to value
Charconv utilities » from_chars: generalized chars to value

Read the first valid sequence of characters from the string, skipping leading whitespace, and convert it using from_chars: generalized chars to value . More...

Functions

size_t c4::from_chars_first (csubstr buf, uint8_t *v) noexcept
 
size_t c4::from_chars_first (csubstr buf, uint16_t *v) noexcept
 
size_t c4::from_chars_first (csubstr buf, uint32_t *v) noexcept
 
size_t c4::from_chars_first (csubstr buf, uint64_t *v) noexcept
 
size_t c4::from_chars_first (csubstr buf, int8_t *v) noexcept
 
size_t c4::from_chars_first (csubstr buf, int16_t *v) noexcept
 
size_t c4::from_chars_first (csubstr buf, int32_t *v) noexcept
 
size_t c4::from_chars_first (csubstr buf, int64_t *v) noexcept
 
size_t c4::from_chars_first (csubstr buf, float *v) noexcept
 
size_t c4::from_chars_first (csubstr buf, double *v) noexcept
 
template<class T >
auto c4::from_chars_first (csubstr buf, T *v) noexcept -> size_t ::type
 
template<class T >
size_t c4::from_chars_first (csubstr buf, T **v) noexcept
 
size_t c4::from_chars_first (csubstr buf, bool *v) noexcept
 
size_t c4::from_chars_first (csubstr buf, char *v) noexcept
 
size_t c4::from_chars_first (substr buf, csubstr *v) noexcept
 
size_t c4::from_chars_first (csubstr buf, substr *v) noexcept
 
size_t c4::from_chars_first (csubstr buf, fmt::raw_wrapper *r)
 read a variable in raw binary format, using memcpy More...
 
size_t c4::from_chars_first (csubstr buf, fmt::raw_wrapper r)
 read a variable in raw binary format, using memcpy More...
 

Detailed Description

Read the first valid sequence of characters from the string, skipping leading whitespace, and convert it using from_chars: generalized chars to value .

Return the number of characters read for converting.

Dispatches to the most appropriate and efficient conversion function.

See also
atou_first, atoi_first, atof_first, atod_first

Function Documentation

◆ from_chars_first() [1/18]

size_t c4::from_chars_first ( csubstr  buf,
uint8_t *  v 
)
inlinenoexcept

Definition at line 2391 of file charconv.hpp.

2391 { return atou_first(buf, v); }
c4::atou_first
size_t atou_first(csubstr str, T *v)
Select the next range of characters in the string that can be parsed as an unsigned integral value,...
Definition: charconv.hpp:1589

References c4::atou_first().

Referenced by c4::uncat(), c4::uncatsep(), and c4::unformat().

◆ from_chars_first() [2/18]

size_t c4::from_chars_first ( csubstr  buf,
uint16_t *  v 
)
inlinenoexcept

Definition at line 2392 of file charconv.hpp.

2392 { return atou_first(buf, v); }

References c4::atou_first().

◆ from_chars_first() [3/18]

size_t c4::from_chars_first ( csubstr  buf,
uint32_t *  v 
)
inlinenoexcept

Definition at line 2393 of file charconv.hpp.

2393 { return atou_first(buf, v); }

References c4::atou_first().

◆ from_chars_first() [4/18]

size_t c4::from_chars_first ( csubstr  buf,
uint64_t *  v 
)
inlinenoexcept

Definition at line 2394 of file charconv.hpp.

2394 { return atou_first(buf, v); }

References c4::atou_first().

◆ from_chars_first() [5/18]

size_t c4::from_chars_first ( csubstr  buf,
int8_t *  v 
)
inlinenoexcept

Definition at line 2395 of file charconv.hpp.

2395 { return atoi_first(buf, v); }
c4::atoi_first
size_t atoi_first(csubstr str, T *v)
Select the next range of characters in the string that can be parsed as a signed integral value,...
Definition: charconv.hpp:1508

References c4::atoi_first().

◆ from_chars_first() [6/18]

size_t c4::from_chars_first ( csubstr  buf,
int16_t *  v 
)
inlinenoexcept

Definition at line 2396 of file charconv.hpp.

2396 { return atoi_first(buf, v); }

References c4::atoi_first().

◆ from_chars_first() [7/18]

size_t c4::from_chars_first ( csubstr  buf,
int32_t *  v 
)
inlinenoexcept

Definition at line 2397 of file charconv.hpp.

2397 { return atoi_first(buf, v); }

References c4::atoi_first().

◆ from_chars_first() [8/18]

size_t c4::from_chars_first ( csubstr  buf,
int64_t *  v 
)
inlinenoexcept

Definition at line 2398 of file charconv.hpp.

2398 { return atoi_first(buf, v); }

References c4::atoi_first().

◆ from_chars_first() [9/18]

size_t c4::from_chars_first ( csubstr  buf,
float *  v 
)
inlinenoexcept

Definition at line 2399 of file charconv.hpp.

2399 { return atof_first(buf, v); }
c4::atof_first
size_t atof_first(csubstr str, float *v) noexcept
Convert a string to a single precision real number.
Definition: charconv.hpp:2149

References c4::atof_first().

◆ from_chars_first() [10/18]

size_t c4::from_chars_first ( csubstr  buf,
double *  v 
)
inlinenoexcept

Definition at line 2400 of file charconv.hpp.

2400 { return atod_first(buf, v); }
c4::atod_first
size_t atod_first(csubstr str, double *v) noexcept
Convert a string to a double precision real number.
Definition: charconv.hpp:2210

References c4::atod_first().

◆ from_chars_first() [11/18]

template<class T >
auto c4::from_chars_first ( csubstr  buf,
T *  v 
) -> size_t ::type
inlinenoexcept

Definition at line 2402 of file charconv.hpp.

2402 { return atoi_first(buf, v); }

◆ from_chars_first() [12/18]

template<class T >
size_t c4::from_chars_first ( csubstr  buf,
T **  v 
)
inlinenoexcept

Definition at line 2405 of file charconv.hpp.

2405 { intptr_t tmp; bool ret = from_chars_first(buf, &tmp); if(ret) { *v = (T*)tmp; } return ret; }
c4::from_chars_first
size_t from_chars_first(csubstr buf, substr *v) noexcept
Definition: charconv.hpp:2618

References c4::from_chars_first().

◆ from_chars_first() [13/18]

size_t c4::from_chars_first ( csubstr  buf,
bool *  v 
)
inlinenoexcept

Definition at line 2491 of file charconv.hpp.

2492 {
2493  csubstr trimmed = buf.first_non_empty_span();
2494  if(trimmed.len == 0 || !from_chars(buf, v))
2495  return csubstr::npos;
2496  return trimmed.len;
2497 }
c4::from_chars
bool from_chars(csubstr buf, substr *v) noexcept
Definition: charconv.hpp:2596
c4::yml::npos
@ npos
a null string position
Definition: common.hpp:267

References c4::from_chars(), and c4::yml::npos.

◆ from_chars_first() [14/18]

size_t c4::from_chars_first ( csubstr  buf,
char *  v 
)
inlinenoexcept

Definition at line 2528 of file charconv.hpp.

2529 {
2530  if(buf.len < 1)
2531  return csubstr::npos;
2532  *v = buf.str[0];
2533  return 1;
2534 }

References c4::yml::npos.

◆ from_chars_first() [15/18]

size_t c4::from_chars_first ( substr  buf,
csubstr *  v 
)
inlinenoexcept

Definition at line 2565 of file charconv.hpp.

2566 {
2567  csubstr trimmed = buf.first_non_empty_span();
2568  if(trimmed.len == 0)
2569  return csubstr::npos;
2570  *v = trimmed;
2571  return static_cast<size_t>(trimmed.end() - buf.begin());
2572 }

References c4::yml::npos.

◆ from_chars_first() [16/18]

size_t c4::from_chars_first ( csubstr  buf,
substr *  v 
)
inlinenoexcept

Definition at line 2618 of file charconv.hpp.

2619 {
2620  csubstr trimmed = buf.first_non_empty_span();
2621  C4_ASSERT(!trimmed.overlaps(*v));
2622  if(C4_UNLIKELY(trimmed.len == 0))
2623  return csubstr::npos;
2624  size_t len = trimmed.len > v->len ? v->len : trimmed.len;
2625  // calling memcpy with null strings is undefined behavior
2626  // and will wreak havoc in calling code's branches.
2627  // see https://github.com/biojppm/rapidyaml/pull/264#issuecomment-1262133637
2628  if(len)
2629  {
2630  C4_ASSERT(buf.str != nullptr);
2631  C4_ASSERT(v->str != nullptr);
2632  memcpy(v->str, trimmed.str, len);
2633  }
2634  if(C4_UNLIKELY(trimmed.len > v->len))
2635  return csubstr::npos;
2636  return static_cast<size_t>(trimmed.end() - buf.begin());
2637 }

References c4::yml::npos.

Referenced by c4::from_chars_first().

◆ from_chars_first() [17/18]

size_t c4::from_chars_first ( csubstr  buf,
fmt::raw_wrapper *  r 
)
inline

read a variable in raw binary format, using memcpy

Definition at line 480 of file format.hpp.

481 {
482  return from_chars(buf, r);
483 }
c4::from_chars
bool from_chars(csubstr buf, fmt::raw_wrapper r)
read a variable in raw binary format, using memcpy
Definition: format.hpp:473

References c4::from_chars().

◆ from_chars_first() [18/18]

size_t c4::from_chars_first ( csubstr  buf,
fmt::raw_wrapper  r 
)
inline

read a variable in raw binary format, using memcpy

Definition at line 486 of file format.hpp.

487 {
488  return from_chars(buf, &r);
489 }

References c4::from_chars().