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
base / win / hstring_reference.h [blame]
// Copyright 2019 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_HSTRING_REFERENCE_H_
#define BASE_WIN_HSTRING_REFERENCE_H_
#include <hstring.h>
#include "base/base_export.h"
namespace base::win {
// HStringReference is an HSTRING representation of a null terminated
// string backed by memory that outlives the HStringReference instance.
//
// If you need an HSTRING class that manages its own memory, you should
// use ScopedHString instead.
//
// Example use:
//
// HStringReference string(L"abc");
//
class BASE_EXPORT HStringReference {
public:
// Creates an HStringReference from `str`, which must be null terminated.
explicit HStringReference(const wchar_t* str);
HSTRING Get() const { return hstring_; }
// HSTRING_HEADER is a structure that contains a pointer to the string
// passed into the constructor, along with its length.
// Since HSTRING is a pointer to HSTRING_HEADER, HStringReference
// cannot be copyable, moveable or assignable, as that would invalidate
// the HSTRING we're passing out to clients.
// In the future, we can consider implementing these methods by storing
// the string passed in the constructor and re-creating the HSTRING and
// HSTRING_HEADER datastructures. For now, we'll keep things simple and
// forbid these operations.
HStringReference(const HStringReference&) = delete;
HStringReference& operator=(const HStringReference&) = delete;
private:
HSTRING hstring_ = nullptr;
HSTRING_HEADER hstring_header_;
};
} // namespace base::win
#endif // BASE_WIN_HSTRING_REFERENCE_H_