| OLD | NEW |
| 1 /* | 1 /* |
| 2 * Copyright 2017 The WebRTC Project Authors. All rights reserved. | 2 * Copyright 2017 The WebRTC Project Authors. All rights reserved. |
| 3 * | 3 * |
| 4 * Use of this source code is governed by a BSD-style license | 4 * Use of this source code is governed by a BSD-style license |
| 5 * that can be found in the LICENSE file in the root of the source | 5 * that can be found in the LICENSE file in the root of the source |
| 6 * tree. An additional intellectual property rights grant can be found | 6 * tree. An additional intellectual property rights grant can be found |
| 7 * in the file PATENTS. All contributing project authors may | 7 * in the file PATENTS. All contributing project authors may |
| 8 * be found in the AUTHORS file in the root of the source tree. | 8 * be found in the AUTHORS file in the root of the source tree. |
| 9 */ | 9 */ |
| 10 | 10 |
| 11 #ifndef WEBRTC_BASE_STRING_TO_NUMBER_H_ | 11 #ifndef WEBRTC_BASE_STRING_TO_NUMBER_H_ |
| 12 #define WEBRTC_BASE_STRING_TO_NUMBER_H_ | 12 #define WEBRTC_BASE_STRING_TO_NUMBER_H_ |
| 13 | 13 |
| 14 #include <string> | |
| 15 #include <limits> | |
| 16 | 14 |
| 17 #include "webrtc/base/optional.h" | 15 // This header is deprecated and is just left here temporarily during |
| 18 | 16 // refactoring. See https://bugs.webrtc.org/7634 for more details. |
| 19 namespace rtc { | 17 #include "webrtc/rtc_base/string_to_number.h" |
| 20 | |
| 21 // This file declares a family of functions to parse integers from strings. | |
| 22 // The standard C library functions either fail to indicate errors (atoi, etc.) | |
| 23 // or are a hassle to work with (strtol, sscanf, etc.). The standard C++ library | |
| 24 // functions (std::stoi, etc.) indicate errors by throwing exceptions, which | |
| 25 // are disabled in WebRTC. | |
| 26 // | |
| 27 // Integers are parsed using one of the following functions: | |
| 28 // rtc::Optional<int-type> StringToNumber(const char* str, int base = 10); | |
| 29 // rtc::Optional<int-type> StringToNumber(const std::string& str, | |
| 30 // int base = 10); | |
| 31 // | |
| 32 // These functions parse a value from the beginning of a string into one of the | |
| 33 // fundamental integer types, or returns an empty Optional if parsing | |
| 34 // failed. Values outside of the range supported by the type will be | |
| 35 // rejected. The strings must begin with a digit or a minus sign. No leading | |
| 36 // space nor trailing contents are allowed. | |
| 37 // By setting base to 0, one of octal, decimal or hexadecimal will be | |
| 38 // detected from the string's prefix (0, nothing or 0x, respectively). | |
| 39 // If non-zero, base can be set to a value between 2 and 36 inclusively. | |
| 40 // | |
| 41 // If desired, this interface could be extended with support for floating-point | |
| 42 // types. | |
| 43 | |
| 44 namespace string_to_number_internal { | |
| 45 // These must be (unsigned) long long, to match the signature of strto(u)ll. | |
| 46 using unsigned_type = unsigned long long; // NOLINT(runtime/int) | |
| 47 using signed_type = long long; // NOLINT(runtime/int) | |
| 48 | |
| 49 rtc::Optional<signed_type> ParseSigned(const char* str, int base); | |
| 50 rtc::Optional<unsigned_type> ParseUnsigned(const char* str, int base); | |
| 51 } // namespace string_to_number_internal | |
| 52 | |
| 53 template <typename T> | |
| 54 typename std::enable_if<std::is_integral<T>::value && std::is_signed<T>::value, | |
| 55 rtc::Optional<T>>::type | |
| 56 StringToNumber(const char* str, int base = 10) { | |
| 57 using string_to_number_internal::signed_type; | |
| 58 static_assert( | |
| 59 std::numeric_limits<T>::max() <= | |
| 60 std::numeric_limits<signed_type>::max() && | |
| 61 std::numeric_limits<T>::lowest() >= | |
| 62 std::numeric_limits<signed_type>::lowest(), | |
| 63 "StringToNumber only supports signed integers as large as long long int"); | |
| 64 rtc::Optional<signed_type> value = | |
| 65 string_to_number_internal::ParseSigned(str, base); | |
| 66 if (value && *value >= std::numeric_limits<T>::lowest() && | |
| 67 *value <= std::numeric_limits<T>::max()) { | |
| 68 return rtc::Optional<T>(static_cast<T>(*value)); | |
| 69 } | |
| 70 return rtc::Optional<T>(); | |
| 71 } | |
| 72 | |
| 73 template <typename T> | |
| 74 typename std::enable_if<std::is_integral<T>::value && | |
| 75 std::is_unsigned<T>::value, | |
| 76 rtc::Optional<T>>::type | |
| 77 StringToNumber(const char* str, int base = 10) { | |
| 78 using string_to_number_internal::unsigned_type; | |
| 79 static_assert(std::numeric_limits<T>::max() <= | |
| 80 std::numeric_limits<unsigned_type>::max(), | |
| 81 "StringToNumber only supports unsigned integers as large as " | |
| 82 "unsigned long long int"); | |
| 83 rtc::Optional<unsigned_type> value = | |
| 84 string_to_number_internal::ParseUnsigned(str, base); | |
| 85 if (value && *value <= std::numeric_limits<T>::max()) { | |
| 86 return rtc::Optional<T>(static_cast<T>(*value)); | |
| 87 } | |
| 88 return rtc::Optional<T>(); | |
| 89 } | |
| 90 | |
| 91 // The std::string overloads only exists if there is a matching const char* | |
| 92 // version. | |
| 93 template <typename T> | |
| 94 auto StringToNumber(const std::string& str, int base = 10) | |
| 95 -> decltype(StringToNumber<T>(str.c_str(), base)) { | |
| 96 return StringToNumber<T>(str.c_str(), base); | |
| 97 } | |
| 98 | |
| 99 } // namespace rtc | |
| 100 | 18 |
| 101 #endif // WEBRTC_BASE_STRING_TO_NUMBER_H_ | 19 #endif // WEBRTC_BASE_STRING_TO_NUMBER_H_ |
| OLD | NEW |