1 //===------------------------- string.cpp ---------------------------------===//
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
7 //===----------------------------------------------------------------------===//
19 _LIBCPP_BEGIN_NAMESPACE_STD
21 template class _LIBCPP_CLASS_TEMPLATE_INSTANTIATION_VIS __basic_string_common<true>;
23 template class _LIBCPP_CLASS_TEMPLATE_INSTANTIATION_VIS basic_string<char>;
24 template class _LIBCPP_CLASS_TEMPLATE_INSTANTIATION_VIS basic_string<wchar_t>;
28 operator+<char, char_traits<char>, allocator<char> >(char const*, string const&);
35 void throw_helper( const string& msg )
37 #ifndef _LIBCPP_NO_EXCEPTIONS
40 fprintf(stderr, "%s\n", msg.c_str());
46 void throw_from_string_out_of_range( const string& func )
48 throw_helper<out_of_range>(func + ": out of range");
52 void throw_from_string_invalid_arg( const string& func )
54 throw_helper<invalid_argument>(func + ": no conversion");
59 template<typename V, typename S, typename F>
62 as_integer_helper(const string& func, const S& str, size_t* idx, int base, F f)
64 typename S::value_type* ptr = nullptr;
65 const typename S::value_type* const p = str.c_str();
66 typename remove_reference<decltype(errno)>::type errno_save = errno;
68 V r = f(p, &ptr, base);
69 swap(errno, errno_save);
70 if (errno_save == ERANGE)
71 throw_from_string_out_of_range(func);
73 throw_from_string_invalid_arg(func);
75 *idx = static_cast<size_t>(ptr - p);
79 template<typename V, typename S>
82 as_integer(const string& func, const S& s, size_t* idx, int base);
88 as_integer(const string& func, const string& s, size_t* idx, int base )
90 // Use long as no Standard string to integer exists.
91 long r = as_integer_helper<long>( func, s, idx, base, strtol );
92 if (r < numeric_limits<int>::min() || numeric_limits<int>::max() < r)
93 throw_from_string_out_of_range(func);
94 return static_cast<int>(r);
100 as_integer(const string& func, const string& s, size_t* idx, int base )
102 return as_integer_helper<long>( func, s, idx, base, strtol );
108 as_integer( const string& func, const string& s, size_t* idx, int base )
110 return as_integer_helper<unsigned long>( func, s, idx, base, strtoul );
116 as_integer( const string& func, const string& s, size_t* idx, int base )
118 return as_integer_helper<long long>( func, s, idx, base, strtoll );
124 as_integer( const string& func, const string& s, size_t* idx, int base )
126 return as_integer_helper<unsigned long long>( func, s, idx, base, strtoull );
133 as_integer( const string& func, const wstring& s, size_t* idx, int base )
135 // Use long as no Stantard string to integer exists.
136 long r = as_integer_helper<long>( func, s, idx, base, wcstol );
137 if (r < numeric_limits<int>::min() || numeric_limits<int>::max() < r)
138 throw_from_string_out_of_range(func);
139 return static_cast<int>(r);
145 as_integer( const string& func, const wstring& s, size_t* idx, int base )
147 return as_integer_helper<long>( func, s, idx, base, wcstol );
153 as_integer( const string& func, const wstring& s, size_t* idx, int base )
155 return as_integer_helper<unsigned long>( func, s, idx, base, wcstoul );
161 as_integer( const string& func, const wstring& s, size_t* idx, int base )
163 return as_integer_helper<long long>( func, s, idx, base, wcstoll );
169 as_integer( const string& func, const wstring& s, size_t* idx, int base )
171 return as_integer_helper<unsigned long long>( func, s, idx, base, wcstoull );
176 template<typename V, typename S, typename F>
179 as_float_helper(const string& func, const S& str, size_t* idx, F f )
181 typename S::value_type* ptr = nullptr;
182 const typename S::value_type* const p = str.c_str();
183 typename remove_reference<decltype(errno)>::type errno_save = errno;
186 swap(errno, errno_save);
187 if (errno_save == ERANGE)
188 throw_from_string_out_of_range(func);
190 throw_from_string_invalid_arg(func);
192 *idx = static_cast<size_t>(ptr - p);
196 template<typename V, typename S>
198 V as_float( const string& func, const S& s, size_t* idx = nullptr );
203 as_float( const string& func, const string& s, size_t* idx )
205 return as_float_helper<float>( func, s, idx, strtof );
211 as_float(const string& func, const string& s, size_t* idx )
213 return as_float_helper<double>( func, s, idx, strtod );
219 as_float( const string& func, const string& s, size_t* idx )
221 return as_float_helper<long double>( func, s, idx, strtold );
227 as_float( const string& func, const wstring& s, size_t* idx )
229 return as_float_helper<float>( func, s, idx, wcstof );
235 as_float( const string& func, const wstring& s, size_t* idx )
237 return as_float_helper<double>( func, s, idx, wcstod );
243 as_float( const string& func, const wstring& s, size_t* idx )
245 return as_float_helper<long double>( func, s, idx, wcstold );
248 } // unnamed namespace
251 stoi(const string& str, size_t* idx, int base)
253 return as_integer<int>( "stoi", str, idx, base );
257 stoi(const wstring& str, size_t* idx, int base)
259 return as_integer<int>( "stoi", str, idx, base );
263 stol(const string& str, size_t* idx, int base)
265 return as_integer<long>( "stol", str, idx, base );
269 stol(const wstring& str, size_t* idx, int base)
271 return as_integer<long>( "stol", str, idx, base );
275 stoul(const string& str, size_t* idx, int base)
277 return as_integer<unsigned long>( "stoul", str, idx, base );
281 stoul(const wstring& str, size_t* idx, int base)
283 return as_integer<unsigned long>( "stoul", str, idx, base );
287 stoll(const string& str, size_t* idx, int base)
289 return as_integer<long long>( "stoll", str, idx, base );
293 stoll(const wstring& str, size_t* idx, int base)
295 return as_integer<long long>( "stoll", str, idx, base );
299 stoull(const string& str, size_t* idx, int base)
301 return as_integer<unsigned long long>( "stoull", str, idx, base );
305 stoull(const wstring& str, size_t* idx, int base)
307 return as_integer<unsigned long long>( "stoull", str, idx, base );
311 stof(const string& str, size_t* idx)
313 return as_float<float>( "stof", str, idx );
317 stof(const wstring& str, size_t* idx)
319 return as_float<float>( "stof", str, idx );
323 stod(const string& str, size_t* idx)
325 return as_float<double>( "stod", str, idx );
329 stod(const wstring& str, size_t* idx)
331 return as_float<double>( "stod", str, idx );
335 stold(const string& str, size_t* idx)
337 return as_float<long double>( "stold", str, idx );
341 stold(const wstring& str, size_t* idx)
343 return as_float<long double>( "stold", str, idx );
353 template<typename S, typename P, typename V >
356 as_string(P sprintf_like, S s, const typename S::value_type* fmt, V a)
358 typedef typename S::size_type size_type;
359 size_type available = s.size();
362 int status = sprintf_like(&s[0], available + 1, fmt, a);
365 size_type used = static_cast<size_type>(status);
366 if ( used <= available )
371 available = used; // Assume this is advice of how much space we need.
374 available = available * 2 + 1;
381 struct initial_string;
384 struct initial_string<string>
390 s.resize(s.capacity());
396 struct initial_string<wstring>
401 wstring s(20, wchar_t());
402 s.resize(s.capacity());
407 typedef int (*wide_printf)(wchar_t* __restrict, size_t, const wchar_t*__restrict, ...);
413 #ifndef _LIBCPP_MSVCRT
416 return static_cast<int (__cdecl*)(wchar_t* __restrict, size_t, const wchar_t*__restrict, ...)>(_snwprintf);
420 template <typename S, typename V>
421 S i_to_string(const V v)
423 // numeric_limits::digits10 returns value less on 1 than desired for unsigned numbers.
424 // For example, for 1-byte unsigned value digits10 is 2 (999 can not be represented),
425 // so we need +1 here.
426 constexpr size_t bufsize = numeric_limits<V>::digits10 + 2; // +1 for minus, +1 for digits10
428 const auto res = to_chars(buf, buf + bufsize, v);
429 _LIBCPP_ASSERT(res.ec == errc(), "bufsize must be large enough to accomodate the value");
430 return S(buf, res.ptr);
433 } // unnamed namespace
435 string to_string (int val) { return i_to_string< string>(val); }
436 string to_string (long val) { return i_to_string< string>(val); }
437 string to_string (long long val) { return i_to_string< string>(val); }
438 string to_string (unsigned val) { return i_to_string< string>(val); }
439 string to_string (unsigned long val) { return i_to_string< string>(val); }
440 string to_string (unsigned long long val) { return i_to_string< string>(val); }
442 wstring to_wstring(int val) { return i_to_string<wstring>(val); }
443 wstring to_wstring(long val) { return i_to_string<wstring>(val); }
444 wstring to_wstring(long long val) { return i_to_string<wstring>(val); }
445 wstring to_wstring(unsigned val) { return i_to_string<wstring>(val); }
446 wstring to_wstring(unsigned long val) { return i_to_string<wstring>(val); }
447 wstring to_wstring(unsigned long long val) { return i_to_string<wstring>(val); }
450 string to_string (float val) { return as_string(snprintf, initial_string< string>()(), "%f", val); }
451 string to_string (double val) { return as_string(snprintf, initial_string< string>()(), "%f", val); }
452 string to_string (long double val) { return as_string(snprintf, initial_string< string>()(), "%Lf", val); }
454 wstring to_wstring(float val) { return as_string(get_swprintf(), initial_string<wstring>()(), L"%f", val); }
455 wstring to_wstring(double val) { return as_string(get_swprintf(), initial_string<wstring>()(), L"%f", val); }
456 wstring to_wstring(long double val) { return as_string(get_swprintf(), initial_string<wstring>()(), L"%Lf", val); }
458 _LIBCPP_END_NAMESPACE_STD