Copy //third_party/quic string libraries to //third_party/quiche
* quic_str_cat_lib -> quiche_str_cat_lib
* quic_string_piece_lib -> quiche_string_piece_lib
* quic_text_utils -> quiche_text_utils
To keep CLs small, a series of followup CLs will modify consumers of
these libraries to use the quiche variant. A final followup CL will
remove the originals from //third_party/quic.
The motivation is to expose base64 functions to our HTTPSSVC parsing
library, which will eventually land in //third_party and be shared
with Chromium via //third_party/quiche.
PiperOrigin-RevId: 284975905
Change-Id: I78d0b65f7a3afb5613d8f9de1c98b4e3bfd9ed8e
diff --git a/common/platform/api/quiche_text_utils.h b/common/platform/api/quiche_text_utils.h
new file mode 100644
index 0000000..c58c676
--- /dev/null
+++ b/common/platform/api/quiche_text_utils.h
@@ -0,0 +1,133 @@
+// Copyright 2016 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+#ifndef QUICHE_COMMON_PLATFORM_API_QUICHE_TEXT_UTILS_H_
+#define QUICHE_COMMON_PLATFORM_API_QUICHE_TEXT_UTILS_H_
+
+#include <string>
+
+#include "net/third_party/quiche/src/common/platform/api/quiche_export.h"
+#include "net/third_party/quiche/src/common/platform/api/quiche_string_piece.h"
+#include "net/quiche/common/platform/impl/quiche_text_utils_impl.h"
+
+namespace quiche {
+
+// Various utilities for manipulating text.
+class QUICHE_EXPORT QuicheTextUtils {
+ public:
+ // Returns true if |data| starts with |prefix|, case sensitively.
+ static bool StartsWith(quiche::QuicheStringPiece data,
+ quiche::QuicheStringPiece prefix) {
+ return quiche::QuicheTextUtilsImpl::StartsWith(data, prefix);
+ }
+
+ // Returns true if |data| ends with |suffix|, case insensitively.
+ static bool EndsWithIgnoreCase(quiche::QuicheStringPiece data,
+ quiche::QuicheStringPiece suffix) {
+ return quiche::QuicheTextUtilsImpl::EndsWithIgnoreCase(data, suffix);
+ }
+
+ // Returns a new string in which |data| has been converted to lower case.
+ static std::string ToLower(quiche::QuicheStringPiece data) {
+ return quiche::QuicheTextUtilsImpl::ToLower(data);
+ }
+
+ // Removes leading and trailing whitespace from |data|.
+ static void RemoveLeadingAndTrailingWhitespace(
+ quiche::QuicheStringPiece* data) {
+ quiche::QuicheTextUtilsImpl::RemoveLeadingAndTrailingWhitespace(data);
+ }
+
+ // Returns true if |in| represents a valid uint64, and stores that value in
+ // |out|.
+ static bool StringToUint64(quiche::QuicheStringPiece in, uint64_t* out) {
+ return quiche::QuicheTextUtilsImpl::StringToUint64(in, out);
+ }
+
+ // Returns true if |in| represents a valid int, and stores that value in
+ // |out|.
+ static bool StringToInt(quiche::QuicheStringPiece in, int* out) {
+ return quiche::QuicheTextUtilsImpl::StringToInt(in, out);
+ }
+
+ // Returns true if |in| represents a valid uint32, and stores that value in
+ // |out|.
+ static bool StringToUint32(quiche::QuicheStringPiece in, uint32_t* out) {
+ return quiche::QuicheTextUtilsImpl::StringToUint32(in, out);
+ }
+
+ // Returns true if |in| represents a valid size_t, and stores that value in
+ // |out|.
+ static bool StringToSizeT(quiche::QuicheStringPiece in, size_t* out) {
+ return quiche::QuicheTextUtilsImpl::StringToSizeT(in, out);
+ }
+
+ // Returns a new string representing |in|.
+ static std::string Uint64ToString(uint64_t in) {
+ return quiche::QuicheTextUtilsImpl::Uint64ToString(in);
+ }
+
+ // This converts |length| bytes of binary to a 2*|length|-character
+ // hexadecimal representation.
+ // Return value: 2*|length| characters of ASCII string.
+ static std::string HexEncode(const char* data, size_t length) {
+ return HexEncode(quiche::QuicheStringPiece(data, length));
+ }
+
+ // This converts |data.length()| bytes of binary to a
+ // 2*|data.length()|-character hexadecimal representation.
+ // Return value: 2*|data.length()| characters of ASCII string.
+ static std::string HexEncode(quiche::QuicheStringPiece data) {
+ return quiche::QuicheTextUtilsImpl::HexEncode(data);
+ }
+
+ // This converts a uint32 into an 8-character hexidecimal
+ // representation. Return value: 8 characters of ASCII string.
+ static std::string Hex(uint32_t v) {
+ return quiche::QuicheTextUtilsImpl::Hex(v);
+ }
+
+ // Converts |data| from a hexadecimal ASCII string to a binary string
+ // that is |data.length()/2| bytes long.
+ static std::string HexDecode(quiche::QuicheStringPiece data) {
+ return quiche::QuicheTextUtilsImpl::HexDecode(data);
+ }
+
+ // Base64 encodes with no padding |data_len| bytes of |data| into |output|.
+ static void Base64Encode(const uint8_t* data,
+ size_t data_len,
+ std::string* output) {
+ return quiche::QuicheTextUtilsImpl::Base64Encode(data, data_len, output);
+ }
+
+ // Returns a string containing hex and ASCII representations of |binary|,
+ // side-by-side in the style of hexdump. Non-printable characters will be
+ // printed as '.' in the ASCII output.
+ // For example, given the input "Hello, QUIC!\01\02\03\04", returns:
+ // "0x0000: 4865 6c6c 6f2c 2051 5549 4321 0102 0304 Hello,.QUIC!...."
+ static std::string HexDump(quiche::QuicheStringPiece binary_data) {
+ return quiche::QuicheTextUtilsImpl::HexDump(binary_data);
+ }
+
+ // Returns true if |data| contains any uppercase characters.
+ static bool ContainsUpperCase(quiche::QuicheStringPiece data) {
+ return quiche::QuicheTextUtilsImpl::ContainsUpperCase(data);
+ }
+
+ // Returns true if |data| contains only decimal digits.
+ static bool IsAllDigits(quiche::QuicheStringPiece data) {
+ return quiche::QuicheTextUtilsImpl::IsAllDigits(data);
+ }
+
+ // Splits |data| into a vector of pieces delimited by |delim|.
+ static std::vector<quiche::QuicheStringPiece> Split(
+ quiche::QuicheStringPiece data,
+ char delim) {
+ return quiche::QuicheTextUtilsImpl::Split(data, delim);
+ }
+};
+
+} // namespace quiche
+
+#endif // QUICHE_COMMON_PLATFORM_API_QUICHE_TEXT_UTILS_H_
