1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
|
// Copyright 2020 The Chromium Authors
// Copyright 2014 Blake Embrey (hello@blakeembrey.com)
// Use of this source code is governed by an MIT-style license that can be
// found in the LICENSE file or at https://opensource.org/licenses/MIT.
#ifndef THIRD_PARTY_LIBURLPATTERN_UTILS_H_
#define THIRD_PARTY_LIBURLPATTERN_UTILS_H_
#include <functional>
#include <string>
#include <string_view>
#include "base/component_export.h"
#include "base/types/expected.h"
#include "third_party/abseil-cpp/absl/status/status.h"
#include "third_party/icu/source/common/unicode/uchar.h"
namespace liburlpattern {
// The "full wildcard" regex pattern. This regex value is treated specially
// resulting in a kFullWildcard Part instead of a kRegex Part.
constexpr const char* kFullWildcardRegex = ".*";
// A type for functor-style callback functions that validate the input and
// potentially perform any encoding necessary. For example, some characters
// could be percent encoded. The final encoded value for the input should be
// returned. The function will be called synchronously for each part of the
// pattern consisting of text to match strictly against an input. For example,
// for the pattern:
//
// `/foo/:bar.html`
//
// The callback will be invoked with `/foo`, `/`, and `.html` separately.
using EncodeCallback =
std::function<base::expected<std::string, absl::Status>(std::string_view)>;
// Return the expected length of the value returned by EscapeString().
COMPONENT_EXPORT(LIBURLPATTERN)
size_t EscapedRegexpStringLength(std::string_view input);
// Escape an input string so that it may be safely included in a
// regular expression.
COMPONENT_EXPORT(LIBURLPATTERN)
std::string EscapeRegexpString(std::string_view input);
// Escape the input string so that it may be safely included in a
// regular expression and append the result directly to the given target.
void EscapeRegexpStringAndAppend(std::string_view input,
std::string& append_target);
// Escape a fixed input string so that it may be safely included in a
// pattern string. Appends the result directly to the given target.
COMPONENT_EXPORT(LIBURLPATTERN)
void EscapePatternStringAndAppend(std::string_view input,
std::string& append_target);
// Return `true` if the given codepoint `c` is valid for a `:foo` name. The
// `first_codepoint` argument can be set if this codepoint is intended to be
// the first codepoint in a name. If its false, then the codepoint is treated
// as a trailing character.
bool IsNameCodepoint(UChar32 c, bool first_codepoint);
} // namespace liburlpattern
#endif // THIRD_PARTY_LIBURLPATTERN_UTILS_H_
|
