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
base / win / scoped_hstring.h [blame]
// Copyright 2017 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef BASE_WIN_SCOPED_HSTRING_H_
#define BASE_WIN_SCOPED_HSTRING_H_
#include <hstring.h>
#include <string>
#include <string_view>
#include "base/scoped_generic.h"
namespace base {
namespace internal {
// Scoped HSTRING class to maintain lifetime of HSTRINGs allocated with
// WindowsCreateString().
struct BASE_EXPORT ScopedHStringTraits {
static HSTRING InvalidValue() { return nullptr; }
static void Free(HSTRING hstr);
};
} // namespace internal
namespace win {
// ScopedHString is a wrapper around an HSTRING.
//
// Example use:
//
// ScopedHString string = ScopedHString::Create(L"abc");
//
// Also:
//
// HSTRING win_string;
// HRESULT hr = WindowsCreateString(..., &win_string);
// ScopedHString string(win_string);
//
class BASE_EXPORT ScopedHString
: public ScopedGeneric<HSTRING, base::internal::ScopedHStringTraits> {
public:
// Constructs a ScopedHString from an HSTRING, and takes ownership of |hstr|.
explicit ScopedHString(HSTRING hstr);
static ScopedHString Create(std::wstring_view str);
static ScopedHString Create(std::string_view str);
// Returns a view into the memory buffer managed by the instance. The returned
// std::string_view is only valid during the lifetime of this ScopedHString
// instance.
std::wstring_view Get() const;
// Returns a copy of the instance as a UTF-8 string.
std::string GetAsUTF8() const;
};
} // namespace win
} // namespace base
#endif // BASE_WIN_SCOPED_HSTRING_H_