// 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. #ifndef URL_URL_CANON_STDSTRING_H_ #define URL_URL_CANON_STDSTRING_H_ // This header file defines a canonicalizer output method class for STL // strings. Because the canonicalizer tries not to be dependent on the STL, // we have segregated it here. #include <string> #include <string_view> #include "base/compiler_specific.h" #include "base/component_export.h" #include "base/memory/raw_ptr_exclusion.h" #include "url/url_canon.h" namespace url { // Write into a std::string given in the constructor. This object does not own // the string itself, and the user must ensure that the string stays alive // throughout the lifetime of this object. // // The given string will be appended to; any existing data in the string will // be preserved. // // Note that when canonicalization is complete, the string will likely have // unused space at the end because we make the string very big to start out // with (by |initial_size|). This ends up being important because resize // operations are slow, and because the base class needs to write directly // into the buffer. // // Therefore, the user should call Complete() before using the string that // this class wrote into. class COMPONENT_EXPORT(URL) StdStringCanonOutput : public CanonOutput { … }; // An extension of the Replacements class that allows the setters to use // string_views (implicitly allowing strings or char*s). // // The contents of the string_views are not copied and must remain valid until // the StringViewReplacements object goes out of scope. // // In order to make it harder to misuse the API the setters do not accept rvalue // references to std::strings. // Note: Extra const char* overloads are necessary to break ambiguities that // would otherwise exist for char literals. template <typename CharT> class StringViewReplacements : public Replacements<CharT> { … }; } // namespace url #endif // URL_URL_CANON_STDSTRING_H_