HDK
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
mapEditor.h
Go to the documentation of this file.
1 //
2 // Copyright 2016 Pixar
3 //
4 // Licensed under the Apache License, Version 2.0 (the "Apache License")
5 // with the following modification; you may not use this file except in
6 // compliance with the Apache License and the following modification to it:
7 // Section 6. Trademarks. is deleted and replaced with:
8 //
9 // 6. Trademarks. This License does not grant permission to use the trade
10 // names, trademarks, service marks, or product names of the Licensor
11 // and its affiliates, except as required to comply with Section 4(c) of
12 // the License and to reproduce the content of the NOTICE file.
13 //
14 // You may obtain a copy of the Apache License at
15 //
16 // http://www.apache.org/licenses/LICENSE-2.0
17 //
18 // Unless required by applicable law or agreed to in writing, software
19 // distributed under the Apache License with the above modification is
20 // distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
21 // KIND, either express or implied. See the Apache License for the specific
22 // language governing permissions and limitations under the Apache License.
23 //
24 #ifndef PXR_USD_SDF_MAP_EDITOR_H
25 #define PXR_USD_SDF_MAP_EDITOR_H
26 
27 #include "pxr/pxr.h"
28 #include "pxr/usd/sdf/allowed.h"
29 #include "pxr/usd/sdf/spec.h"
30 
31 #include <memory>
32 #include <string>
33 #include <utility>
34 
36 
37 class TfToken;
38 
39 /// \class Sdf_MapEditor
40 ///
41 /// Interface for private implementations used by SdfMapEditProxy.
42 ///
43 template <class MapType>
45 public:
46  typedef typename MapType::key_type key_type;
47  typedef typename MapType::mapped_type mapped_type;
48  typedef typename MapType::value_type value_type;
49  typedef typename MapType::iterator iterator;
50 
51  virtual ~Sdf_MapEditor();
52 
53  /// Returns a string describing the location of the map being edited.
54  /// This is used for debugging and error messages.
55  virtual std::string GetLocation() const = 0;
56 
57  /// Returns owner of the map being edited.
58  virtual SdfSpecHandle GetOwner() const = 0;
59 
60  /// Returns true if the map being edited is expired, false otherwise.
61  virtual bool IsExpired() const = 0;
62 
63  /// Returns const pointer to map being edited.
64  virtual const MapType* GetData() const = 0;
65 
66  /// Returns non-const pointer to map being edited.
67  /// All edits to the map should be done using the editing functions below.
68  /// This function is primarily here for convenience. Ideally, only the
69  /// const version of this function would exist.
70  virtual MapType* GetData() = 0;
71 
72  /// \name Editing Operations
73  /// @{
74 
75  virtual void Copy(const MapType& other) = 0;
76  virtual void Set(const key_type& key, const mapped_type& other) = 0;
77  virtual std::pair<iterator, bool> Insert(const value_type& value) = 0;
78  virtual bool Erase(const key_type& key) = 0;
79 
80  virtual SdfAllowed IsValidKey(const key_type& key) const = 0;
81  virtual SdfAllowed IsValidValue(const mapped_type& value) const = 0;
82 
83  /// @}
84 
85 protected:
86  Sdf_MapEditor();
87 
88 };
89 
90 template <class T>
91 std::unique_ptr<Sdf_MapEditor<T> >
92 Sdf_CreateMapEditor(const SdfSpecHandle& owner, const TfToken& field);
93 
95 
96 #endif // PXR_USD_SDF_MAP_EDITOR_H
MapType::mapped_type mapped_type
Definition: mapEditor.h:47
GLsizei const GLchar *const * string
Definition: glcorearb.h:814
virtual SdfSpecHandle GetOwner() const =0
Returns owner of the map being edited.
virtual bool IsExpired() const =0
Returns true if the map being edited is expired, false otherwise.
virtual SdfAllowed IsValidValue(const mapped_type &value) const =0
uint64 value_type
Definition: GA_PrimCompat.h:29
virtual std::pair< iterator, bool > Insert(const value_type &value)=0
virtual ~Sdf_MapEditor()
virtual std::string GetLocation() const =0
MapType::iterator iterator
Definition: mapEditor.h:49
Definition: token.h:87
virtual void Copy(const MapType &other)=0
virtual void Set(const key_type &key, const mapped_type &other)=0
virtual const MapType * GetData() const =0
Returns const pointer to map being edited.
virtual SdfAllowed IsValidKey(const key_type &key) const =0
virtual bool Erase(const key_type &key)=0
PXR_NAMESPACE_CLOSE_SCOPE PXR_NAMESPACE_OPEN_SCOPE
Definition: path.h:1432
#define PXR_NAMESPACE_CLOSE_SCOPE
Definition: pxr.h:91
std::unique_ptr< Sdf_MapEditor< T > > Sdf_CreateMapEditor(const SdfSpecHandle &owner, const TfToken &field)
Definition: core.h:1131
MapType::value_type value_type
Definition: mapEditor.h:48
MapType::key_type key_type
Definition: mapEditor.h:46