| // Copyright 2013 The Chromium Authors | |
| // Use of this source code is governed by a BSD-style license that can be | |
| // found in the LICENSE file. | |
| // This is a copy of url/url_canon_internal.h circa 2023. It should be used only | |
| // by components/feedback/redaction_tool/. We need a copy because the | |
| // components/feedback/redaction_tool source code is shared into ChromeOS and | |
| // needs to have no dependencies outside of base/. | |
| #ifndef COMPONENTS_FEEDBACK_REDACTION_TOOL_URL_CANON_INTERNAL_H_ | |
| #define COMPONENTS_FEEDBACK_REDACTION_TOOL_URL_CANON_INTERNAL_H_ | |
| // This file is intended to be included in another C++ file where the character | |
| // types are defined. This allows us to write mostly generic code, but not have | |
| // template bloat because everything is inlined when anybody calls any of our | |
| // functions. | |
| #include <stddef.h> | |
| #include <stdlib.h> | |
| #include <array> | |
| #include "base/compiler_specific.h" | |
| #include "base/containers/span.h" | |
| #include "components/feedback/redaction_tool/url_canon.h" | |
| namespace redaction_internal { | |
| // Character type handling ----------------------------------------------------- | |
| // Bits that identify different character types. These types identify different | |
| // bits that are set for each 8-bit character in the kSharedCharTypeTable. | |
| enum SharedCharTypes { | |
| // Characters that do not require escaping in queries. Characters that do | |
| // not have this flag will be escaped; see url_canon_query.cc | |
| CHAR_QUERY = 1, | |
| // Valid in the username/password field. | |
| CHAR_USERINFO = 2, | |
| // Valid in a IPv4 address (digits plus dot and 'x' for hex). | |
| CHAR_IPV4 = 4, | |
| // Valid in an ASCII-representation of a hex digit (as in %-escaped). | |
| CHAR_HEX = 8, | |
| // Valid in an ASCII-representation of a decimal digit. | |
| CHAR_DEC = 16, | |
| // Valid in an ASCII-representation of an octal digit. | |
| CHAR_OCT = 32, | |
| // Characters that do not require escaping in encodeURIComponent. Characters | |
| // that do not have this flag will be escaped; see url_util.cc. | |
| CHAR_COMPONENT = 64, | |
| }; | |
| // This table contains the flags in SharedCharTypes for each 8-bit character. | |
| // Some canonicalization functions have their own specialized lookup table. | |
| // For those with simple requirements, we have collected the flags in one | |
| // place so there are fewer lookup tables to load into the CPU cache. | |
| // | |
| // Using an unsigned char type has a small but measurable performance benefit | |
| // over using a 32-bit number. | |
| extern const std::array<unsigned char, 0x100> kSharedCharTypeTable; | |
| // More readable wrappers around the character type lookup table. | |
| inline bool IsCharOfType(unsigned char c, SharedCharTypes type) { | |
| return !!(kSharedCharTypeTable[c] & type); | |
| } | |
| inline bool IsQueryChar(unsigned char c) { | |
| return IsCharOfType(c, CHAR_QUERY); | |
| } | |
| inline bool IsIPv4Char(unsigned char c) { | |
| return IsCharOfType(c, CHAR_IPV4); | |
| } | |
| inline bool IsHexChar(unsigned char c) { | |
| return IsCharOfType(c, CHAR_HEX); | |
| } | |
| inline bool IsComponentChar(unsigned char c) { | |
| return IsCharOfType(c, CHAR_COMPONENT); | |
| } | |
| #ifndef WIN32 | |
| // Implementations of Windows' int-to-string conversions | |
| int _itoa_s(int value, base::span<char> buffer, int radix); | |
| // Secure template overloads for these functions | |
| template <size_t N> | |
| inline int _itoa_s(int value, char (&buffer)[N], int radix) { | |
| return _itoa_s(value, base::span(buffer), radix); | |
| } | |
| // _strtoui64 and strtoull behave the same | |
| inline uint64_t _strtoui64(const char* nptr, char** endptr, int base) { | |
| // SAFETY: This is a wrapper around the standard library function strtoull. | |
| // The caller must ensure nptr is null-terminated. | |
| return UNSAFE_BUFFERS(strtoull(nptr, endptr, base)); | |
| } | |
| #endif // WIN32 | |
| } // namespace redaction_internal | |
| #endif // COMPONENTS_FEEDBACK_REDACTION_TOOL_URL_CANON_INTERNAL_H_ |