forked from PixarAnimationStudios/OpenUSD
-
Notifications
You must be signed in to change notification settings - Fork 0
/
assetPath.h
151 lines (124 loc) · 4.61 KB
/
assetPath.h
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
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
//
// Copyright 2016 Pixar
//
// Licensed under the Apache License, Version 2.0 (the "Apache License")
// with the following modification; you may not use this file except in
// compliance with the Apache License and the following modification to it:
// Section 6. Trademarks. is deleted and replaced with:
//
// 6. Trademarks. This License does not grant permission to use the trade
// names, trademarks, service marks, or product names of the Licensor
// and its affiliates, except as required to comply with Section 4(c) of
// the License and to reproduce the content of the NOTICE file.
//
// You may obtain a copy of the Apache License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the Apache License with the above modification is
// distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
// KIND, either express or implied. See the Apache License for the specific
// language governing permissions and limitations under the Apache License.
//
#ifndef PXR_USD_SDF_ASSET_PATH_H
#define PXR_USD_SDF_ASSET_PATH_H
/// \file sdf/assetPath.h
#include "pxr/pxr.h"
#include "pxr/usd/sdf/api.h"
#include <boost/functional/hash.hpp>
#include <boost/operators.hpp>
#include <iosfwd>
#include <string>
PXR_NAMESPACE_OPEN_SCOPE
/// \class SdfAssetPath
///
/// Contains an asset path and an optional resolved path. Asset paths may
/// contain non-control UTF-8 encoded characters. Specifically, U+0000..U+001F
/// (C0 controls), U+007F (delete), and U+0080..U+009F (C1 controls) are
/// disallowed. Attempts to construct asset paths with such characters will
/// issue a TfError and produce the default-constructed empty asset path.
///
class SdfAssetPath:
public boost::totally_ordered<SdfAssetPath>
{
public:
/// \name Constructors
/// @{
///
/// Construct an empty asset path.
SDF_API SdfAssetPath();
/// Construct an asset path with \p path and no associated resolved path.
///
/// If the passed \p path is not valid UTF-8 or contains C0 or C1 control
/// characters, raise a TfError and return the default-constructed empty
/// asset path.
SDF_API explicit SdfAssetPath(const std::string &path);
/// Construct an asset path with \p path and an associated \p resolvedPath.
///
/// If either the passed \path or \p resolvedPath are not valid UTF-8 or
/// either contain C0 or C1 control characters, raise a TfError and return
/// the default-constructed empty asset path.
SDF_API
SdfAssetPath(const std::string &path, const std::string &resolvedPath);
/// @}
///\name Operators
/// @{
/// Equality, including the resolved path.
bool operator==(const SdfAssetPath &rhs) const {
return _assetPath == rhs._assetPath &&
_resolvedPath == rhs._resolvedPath;
}
/// Ordering first by asset path, then by resolved path.
SDF_API bool operator<(const SdfAssetPath &rhs) const;
/// Hash function
size_t GetHash() const {
size_t hash = 0;
boost::hash_combine(hash, _assetPath);
boost::hash_combine(hash, _resolvedPath);
return hash;
}
/// \class Hash
struct Hash
{
size_t operator()(const SdfAssetPath &ap) const {
return ap.GetHash();
}
};
friend size_t hash_value(const SdfAssetPath &ap) { return ap.GetHash(); }
/// @}
/// \name Accessors
/// @{
/// Return the asset path.
const std::string &GetAssetPath() const {
return _assetPath;
}
/// Return the resolved asset path, if any.
///
/// Note that SdfAssetPath carries a resolved path only if its creator
/// passed one to the constructor. SdfAssetPath never performs resolution
/// itself.
const std::string &GetResolvedPath() const {
return _resolvedPath;
}
/// @}
private:
friend inline void swap(SdfAssetPath &lhs, SdfAssetPath &rhs) {
lhs._assetPath.swap(rhs._assetPath);
lhs._resolvedPath.swap(rhs._resolvedPath);
}
std::string _assetPath;
std::string _resolvedPath;
};
/// \name Related
/// @{
/// Stream insertion operator for the string representation of this assetPath.
///
/// \note This always encodes only the result of GetAssetPath(). The resolved
/// path is ignored for the purpose of this operator. This means that
/// two SdfAssetPath s that do not compare equal may produce
/// indistinguishable ostream output.
SDF_API std::ostream& operator<<(std::ostream& out, const SdfAssetPath& ap);
/// @}
PXR_NAMESPACE_CLOSE_SCOPE
#endif // PXR_USD_SDF_ASSET_PATH_H