ToChars.h File Reference

Define functions to convert numeric types to string representation. More...

#include <system_error>

Include dependency graph for ToChars.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
struct	ToCharsResult
	Result of the conversion, similar to std::to_chars_result. More...

Functions
STRING_UTILS_API ToCharsResult	ToChars (char *buffer, char *last, float value, int digitsAfterDecimalPoint=-1) noexcept
	Convert a single precision floating point number to a string, always uses the dot as decimal. More...
STRING_UTILS_API ToCharsResult	ToChars (char *buffer, char *last, double value, int digitsAfterDecimalPoint=-1) noexcept
	Convert a double precision floating point number to a string, always uses the dot as decimal. More...
STRING_UTILS_API ToCharsResult	ToChars (char *buffer, char *last, long long value) noexcept
	Convert a signed 64 bit integer value to string. More...
STRING_UTILS_API ToCharsResult	ToChars (char *buffer, char *last, unsigned long long value) noexcept
	Convert a unsigned 64 bit integer value to string. More...

Detailed Description

Define functions to convert numeric types to string representation.

Declare functions to convert numeric types to string representation.

---

Audacity: A Digital Audio Editor

Dmitry Vedenko

Definition in file ToChars.h.

Function Documentation

ToChars() [1/4]

STRING_UTILS_API ToCharsResult ToChars ( char *  buffer, char *  last, double  value, int  digitsAfterDecimalPoint = -1  )

noexcept

Convert a double precision floating point number to a string, always uses the dot as decimal.

Definition at line 1233 of file ToChars.cpp.

{
   return internal::float_to_chars(
      buffer, last, value, digitsAfterDecimalPoint);
}

References internal::float_to_chars().

Here is the call graph for this function:

ToChars() [2/4]

STRING_UTILS_API ToCharsResult ToChars ( char *  buffer, char *  last, float  value, int  digitsAfterDecimalPoint = -1  )

noexcept

Convert a single precision floating point number to a string, always uses the dot as decimal.

Definition at line 1225 of file ToChars.cpp.

{
   return internal::float_to_chars(
      buffer, last, value, digitsAfterDecimalPoint);
}

References internal::float_to_chars().

Referenced by ToChars(), and XMLUtf8BufferWriter::WriteAttr().

Here is the call graph for this function:

Here is the caller graph for this function:

ToChars() [3/4]

STRING_UTILS_API ToCharsResult ToChars ( char *  buffer, char *  last, long long  value  )

noexcept

Convert a signed 64 bit integer value to string.

Definition at line 1242 of file ToChars.cpp.

{
   if (buffer >= last || buffer == nullptr)
      return { last, std::errc::value_too_large };
 
   if (value < 0)
   {
      *buffer++ = '-';
      value = -value;
   }
 
   return ToChars(buffer, last, static_cast<unsigned long long>(value));
}

References ToChars().

Here is the call graph for this function:

ToChars() [4/4]

STRING_UTILS_API ToCharsResult ToChars ( char *  buffer, char *  last, unsigned long long  value  )

noexcept

Convert a unsigned 64 bit integer value to string.

Definition at line 1256 of file ToChars.cpp.

{
   if (buffer >= last || buffer == nullptr)
      return { last, std::errc::value_too_large };
 
   if (value == 0)
   {
      *buffer++ = '0';
      return { buffer, std::errc() };
   }
 
   constexpr size_t safeSize =
      std::numeric_limits<unsigned long long>::digits10 + 2;
 
   const size_t bufferSize = static_cast<size_t>(last - buffer);
 
   if (bufferSize >= safeSize)
      return { internal::itoa_impl::u64toa_jeaiii(value, buffer), std::errc() };
 
   char tempBuffer[safeSize];
   char* tempLast = internal::itoa_impl::u64toa_jeaiii(value, tempBuffer);
 
   const size_t resultSize = static_cast<size_t>(tempLast - tempBuffer);
 
   if (resultSize > bufferSize)
      return { last, std::errc::value_too_large };
 
   std::copy(tempBuffer, tempLast, buffer);
 
   return { buffer + resultSize, std::errc() };
}

References staffpad::vo::copy(), and internal::itoa_impl::u64toa_jeaiii().

Here is the call graph for this function: