123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200 |
- // Copyright 2013 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 BASE_STRINGS_STRING_UTIL_WIN_H_
- #define BASE_STRINGS_STRING_UTIL_WIN_H_
- #include <stdarg.h>
- #include <stddef.h>
- #include <stdio.h>
- #include <string.h>
- #include <wchar.h>
- #include <string>
- #include <vector>
- #include "base/check.h"
- #include "base/containers/span.h"
- #include "base/strings/string_piece.h"
- #include "base/strings/string_util.h"
- namespace base {
- // Chromium code style is to not use malloc'd strings; this is only for use
- // for interaction with APIs that require it.
- inline char* strdup(const char* str) {
- return _strdup(str);
- }
- inline int vsnprintf(char* buffer, size_t size,
- const char* format, va_list arguments) {
- int length = vsnprintf_s(buffer, size, size - 1, format, arguments);
- if (length < 0)
- return _vscprintf(format, arguments);
- return length;
- }
- inline int vswprintf(wchar_t* buffer, size_t size,
- const wchar_t* format, va_list arguments) {
- DCHECK(IsWprintfFormatPortable(format));
- int length = _vsnwprintf_s(buffer, size, size - 1, format, arguments);
- if (length < 0)
- return _vscwprintf(format, arguments);
- return length;
- }
- // Utility functions to access the underlying string buffer as a wide char
- // pointer.
- //
- // Note: These functions violate strict aliasing when char16_t and wchar_t are
- // unrelated types. We thus pass -fno-strict-aliasing to the compiler on
- // non-Windows platforms [1], and rely on it being off in Clang's CL mode [2].
- //
- // [1] https://crrev.com/b9a0976622/build/config/compiler/BUILD.gn#244
- // [2]
- // https://github.com/llvm/llvm-project/blob/1e28a66/clang/lib/Driver/ToolChains/Clang.cpp#L3949
- inline wchar_t* as_writable_wcstr(char16_t* str) {
- return reinterpret_cast<wchar_t*>(str);
- }
- inline wchar_t* as_writable_wcstr(std::u16string& str) {
- return reinterpret_cast<wchar_t*>(data(str));
- }
- inline const wchar_t* as_wcstr(const char16_t* str) {
- return reinterpret_cast<const wchar_t*>(str);
- }
- inline const wchar_t* as_wcstr(StringPiece16 str) {
- return reinterpret_cast<const wchar_t*>(str.data());
- }
- // Utility functions to access the underlying string buffer as a char16_t
- // pointer.
- inline char16_t* as_writable_u16cstr(wchar_t* str) {
- return reinterpret_cast<char16_t*>(str);
- }
- inline char16_t* as_writable_u16cstr(std::wstring& str) {
- return reinterpret_cast<char16_t*>(data(str));
- }
- inline const char16_t* as_u16cstr(const wchar_t* str) {
- return reinterpret_cast<const char16_t*>(str);
- }
- inline const char16_t* as_u16cstr(WStringPiece str) {
- return reinterpret_cast<const char16_t*>(str.data());
- }
- // Utility functions to convert between base::WStringPiece and
- // base::StringPiece16.
- inline WStringPiece AsWStringPiece(StringPiece16 str) {
- return WStringPiece(as_wcstr(str.data()), str.size());
- }
- inline StringPiece16 AsStringPiece16(WStringPiece str) {
- return StringPiece16(as_u16cstr(str.data()), str.size());
- }
- inline std::wstring AsWString(StringPiece16 str) {
- return std::wstring(as_wcstr(str.data()), str.size());
- }
- inline std::u16string AsString16(WStringPiece str) {
- return std::u16string(as_u16cstr(str.data()), str.size());
- }
- // The following section contains overloads of the cross-platform APIs for
- // std::wstring and base::WStringPiece.
- BASE_EXPORT bool IsStringASCII(WStringPiece str);
- BASE_EXPORT std::wstring ToLowerASCII(WStringPiece str);
- BASE_EXPORT std::wstring ToUpperASCII(WStringPiece str);
- BASE_EXPORT int CompareCaseInsensitiveASCII(WStringPiece a, WStringPiece b);
- inline bool EqualsCaseInsensitiveASCII(WStringPiece a, WStringPiece b) {
- return internal::EqualsCaseInsensitiveASCIIT(a, b);
- }
- inline bool EqualsCaseInsensitiveASCII(WStringPiece a, StringPiece b) {
- return internal::EqualsCaseInsensitiveASCIIT(a, b);
- }
- inline bool EqualsCaseInsensitiveASCII(StringPiece a, WStringPiece b) {
- return internal::EqualsCaseInsensitiveASCIIT(a, b);
- }
- BASE_EXPORT bool RemoveChars(WStringPiece input,
- WStringPiece remove_chars,
- std::wstring* output);
- BASE_EXPORT bool ReplaceChars(WStringPiece input,
- WStringPiece replace_chars,
- WStringPiece replace_with,
- std::wstring* output);
- BASE_EXPORT bool TrimString(WStringPiece input,
- WStringPiece trim_chars,
- std::wstring* output);
- BASE_EXPORT WStringPiece TrimString(WStringPiece input,
- WStringPiece trim_chars,
- TrimPositions positions);
- BASE_EXPORT TrimPositions TrimWhitespace(WStringPiece input,
- TrimPositions positions,
- std::wstring* output);
- BASE_EXPORT WStringPiece TrimWhitespace(WStringPiece input,
- TrimPositions positions);
- BASE_EXPORT std::wstring CollapseWhitespace(
- WStringPiece text,
- bool trim_sequences_with_line_breaks);
- BASE_EXPORT bool ContainsOnlyChars(WStringPiece input, WStringPiece characters);
- BASE_EXPORT bool EqualsASCII(StringPiece16 str, StringPiece ascii);
- BASE_EXPORT bool StartsWith(
- WStringPiece str,
- WStringPiece search_for,
- CompareCase case_sensitivity = CompareCase::SENSITIVE);
- BASE_EXPORT bool EndsWith(
- WStringPiece str,
- WStringPiece search_for,
- CompareCase case_sensitivity = CompareCase::SENSITIVE);
- BASE_EXPORT void ReplaceFirstSubstringAfterOffset(std::wstring* str,
- size_t start_offset,
- WStringPiece find_this,
- WStringPiece replace_with);
- BASE_EXPORT void ReplaceSubstringsAfterOffset(std::wstring* str,
- size_t start_offset,
- WStringPiece find_this,
- WStringPiece replace_with);
- BASE_EXPORT wchar_t* WriteInto(std::wstring* str, size_t length_with_null);
- BASE_EXPORT std::wstring JoinString(span<const std::wstring> parts,
- WStringPiece separator);
- BASE_EXPORT std::wstring JoinString(span<const WStringPiece> parts,
- WStringPiece separator);
- BASE_EXPORT std::wstring JoinString(std::initializer_list<WStringPiece> parts,
- WStringPiece separator);
- BASE_EXPORT std::wstring ReplaceStringPlaceholders(
- WStringPiece format_string,
- const std::vector<std::wstring>& subst,
- std::vector<size_t>* offsets);
- } // namespace base
- #endif // BASE_STRINGS_STRING_UTIL_WIN_H_
|