IDS peak genericC++ v1.15.0
Loading...
Searching...
No Matches
peak_enumeration_node.hpp
Go to the documentation of this file.
1
10
11#pragma once
12
13
15#include <peak/dll_interface/peak_dll_interface_util.hpp>
18
19#include <algorithm>
20#include <cstddef>
21#include <cstdint>
22#include <string>
23#include <vector>
24#include <type_traits>
25
26
27namespace peak
28{
29namespace core
30{
31namespace nodes
32{
33
39class EnumerationNode : public Node
40{
41public:
42 static constexpr auto NodeType = nodes::NodeType::Enumeration;
43 using NodeDataType = std::string;
44 using NodeHasRange = std::false_type;
45
46 EnumerationNode() = delete;
47 ~EnumerationNode() override = default;
48 EnumerationNode(const EnumerationNode& other) = delete;
49 EnumerationNode& operator=(const EnumerationNode& other) = delete;
52
65 std::shared_ptr<EnumerationEntryNode> CurrentEntry(
67
79 void SetCurrentEntry(const std::shared_ptr<EnumerationEntryNode>& entry);
80
92 void SetCurrentEntry(const std::string& symbolicValue);
93
105 void SetCurrentEntry(int64_t value);
106
120 bool HasEntry(const std::string& symbolicValue) const;
121
134 bool HasEntry(int64_t value) const;
135
149 std::shared_ptr<EnumerationEntryNode> FindEntry(const std::string& symbolicValue) const;
150
164 std::shared_ptr<EnumerationEntryNode> FindEntry(int64_t value) const;
165
177 std::shared_ptr<EnumerationEntryNode> TryFindEntry(const std::string& symbolicValue) const;
178
190 std::shared_ptr<EnumerationEntryNode> TryFindEntry(const int64_t value) const;
191
201 std::vector<std::shared_ptr<EnumerationEntryNode>> Entries() const;
202
212 std::vector<std::shared_ptr<EnumerationEntryNode>> AvailableEntries() const;
213
214private:
215 friend ClassCreator<EnumerationNode>;
216 EnumerationNode(PEAK_ENUMERATION_NODE_HANDLE enumerationNodeHandle, const std::weak_ptr<NodeMap>& parentNodeMap);
217 PEAK_ENUMERATION_NODE_HANDLE m_backendHandle;
218};
219
220} /* namespace nodes */
221} /* namespace core */
222} /* namespace peak */
223
224/* Implementation */
225namespace peak
226{
227namespace core
228{
229namespace nodes
230{
231
233 PEAK_ENUMERATION_NODE_HANDLE enumerationNodeHandle, const std::weak_ptr<NodeMap>& parentNodeMap)
234 : Node(QueryNumericFromCInterfaceFunction<PEAK_NODE_HANDLE>([&](PEAK_NODE_HANDLE* nodeHandle) {
235 return PEAK_C_ABI_PREFIX PEAK_EnumerationNode_ToNode(enumerationNodeHandle, nodeHandle);
236 }),
237 parentNodeMap)
238 , m_backendHandle(enumerationNodeHandle)
239{}
240
241inline std::shared_ptr<EnumerationEntryNode> EnumerationNode::CurrentEntry(
242 NodeCacheUsePolicy cacheUsePolicy /* = NodeCacheUsePolicy::UseCache */) const
243{
244 auto enumerationEntryNodeHandle = QueryNumericFromCInterfaceFunction<PEAK_ENUMERATION_ENTRY_NODE_HANDLE>(
245 [&](PEAK_ENUMERATION_ENTRY_NODE_HANDLE* _enumerationEntryNodeHandle) {
247 static_cast<PEAK_NODE_CACHE_USE_POLICY>(cacheUsePolicy), _enumerationEntryNodeHandle);
248 });
249
250 auto nodeHandle = QueryNumericFromCInterfaceFunction<PEAK_NODE_HANDLE>([&](PEAK_NODE_HANDLE* _nodeHandle) {
251 return PEAK_C_ABI_PREFIX PEAK_EnumerationEntryNode_ToNode(enumerationEntryNodeHandle, _nodeHandle);
252 });
253
254 auto nodeName = GetNodeName(nodeHandle);
255
256 return std::dynamic_pointer_cast<EnumerationEntryNode>(ParentNodeMap()->FindNode(nodeName));
257}
258
259inline void EnumerationNode::SetCurrentEntry(const std::shared_ptr<EnumerationEntryNode>& entry)
260{
261 if (entry == nullptr)
262 {
263 throw InvalidArgumentException("The given entry is a nullptr!");
264 }
265
266 CallAndCheckCInterfaceFunction([&] {
267 return PEAK_C_ABI_PREFIX PEAK_EnumerationNode_SetCurrentEntry(m_backendHandle, entry->m_backendHandle);
268 });
269}
270
271inline void EnumerationNode::SetCurrentEntry(const std::string& symbolicValue)
272{
273 CallAndCheckCInterfaceFunction([&] {
275 m_backendHandle, symbolicValue.c_str(), symbolicValue.size() + 1);
276 });
277}
278
279inline void EnumerationNode::SetCurrentEntry(int64_t value)
280{
281 CallAndCheckCInterfaceFunction(
282 [&] { return PEAK_C_ABI_PREFIX PEAK_EnumerationNode_SetCurrentEntryByValue(m_backendHandle, value); });
283}
284
285inline bool EnumerationNode::HasEntry(const std::string& symbolicValue) const
286{
287 return QueryNumericFromCInterfaceFunction<PEAK_BOOL8>([&](PEAK_BOOL8* hasEntry) {
289 m_backendHandle, symbolicValue.c_str(), symbolicValue.size() + 1, hasEntry);
290 }) > 0;
291}
292
293inline bool EnumerationNode::HasEntry(int64_t value) const
294{
295 return QueryNumericFromCInterfaceFunction<PEAK_BOOL8>([&](PEAK_BOOL8* hasEntry) {
296 return PEAK_C_ABI_PREFIX PEAK_EnumerationNode_GetHasEntryByValue(m_backendHandle, value, hasEntry);
297 }) > 0;
298}
299
300inline std::shared_ptr<EnumerationEntryNode> EnumerationNode::FindEntry(const std::string& symbolicValue) const
301{
302 auto enumerationEntryNodeHandle = QueryNumericFromCInterfaceFunction<PEAK_ENUMERATION_ENTRY_NODE_HANDLE>(
303 [&](PEAK_ENUMERATION_ENTRY_NODE_HANDLE* _enumerationEntryNodeHandle) {
305 m_backendHandle, symbolicValue.c_str(), symbolicValue.size() + 1, _enumerationEntryNodeHandle);
306 });
307
308 auto nodeHandle = QueryNumericFromCInterfaceFunction<PEAK_NODE_HANDLE>([&](PEAK_NODE_HANDLE* _nodeHandle) {
309 return PEAK_C_ABI_PREFIX PEAK_EnumerationEntryNode_ToNode(enumerationEntryNodeHandle, _nodeHandle);
310 });
311
312 auto nodeName = GetNodeName(nodeHandle);
313
314 return std::dynamic_pointer_cast<EnumerationEntryNode>(ParentNodeMap()->FindNode(nodeName));
315}
316
317inline std::shared_ptr<EnumerationEntryNode> EnumerationNode::FindEntry(int64_t value) const
318{
319 auto enumerationEntryNodeHandle = QueryNumericFromCInterfaceFunction<PEAK_ENUMERATION_ENTRY_NODE_HANDLE>(
320 [&](PEAK_ENUMERATION_ENTRY_NODE_HANDLE* _enumerationEntryNodeHandle) {
322 m_backendHandle, value, _enumerationEntryNodeHandle);
323 });
324
325 auto nodeHandle = QueryNumericFromCInterfaceFunction<PEAK_NODE_HANDLE>([&](PEAK_NODE_HANDLE* _nodeHandle) {
326 return PEAK_C_ABI_PREFIX PEAK_EnumerationEntryNode_ToNode(enumerationEntryNodeHandle, _nodeHandle);
327 });
328
329 auto nodeName = GetNodeName(nodeHandle);
330
331 return std::dynamic_pointer_cast<EnumerationEntryNode>(ParentNodeMap()->FindNode(nodeName));
332}
333
334
335inline std::shared_ptr<EnumerationEntryNode> EnumerationNode::TryFindEntry(const std::string& symbolicValue) const
336{
337 auto enumerationEntryNodeHandle = QueryNumericFromCInterfaceFunction<PEAK_ENUMERATION_ENTRY_NODE_HANDLE>(
338 [&](PEAK_ENUMERATION_ENTRY_NODE_HANDLE* _enumerationEntryNodeHandle) {
340 m_backendHandle, symbolicValue.c_str(), symbolicValue.size() + 1, _enumerationEntryNodeHandle);
341 });
342
343 if(enumerationEntryNodeHandle == nullptr)
344 {
345 return nullptr;
346 }
347
348 auto nodeHandle = QueryNumericFromCInterfaceFunction<PEAK_NODE_HANDLE>([&](PEAK_NODE_HANDLE* _nodeHandle) {
349 return PEAK_C_ABI_PREFIX PEAK_EnumerationEntryNode_ToNode(enumerationEntryNodeHandle, _nodeHandle);
350 });
351
352 auto nodeName = GetNodeName(nodeHandle);
353
354 return std::dynamic_pointer_cast<EnumerationEntryNode>(ParentNodeMap()->FindNode(nodeName));
355}
356
357inline std::shared_ptr<EnumerationEntryNode> EnumerationNode::TryFindEntry(const int64_t value) const
358{
359 auto enumerationEntryNodeHandle = QueryNumericFromCInterfaceFunction<PEAK_ENUMERATION_ENTRY_NODE_HANDLE>(
360 [&](PEAK_ENUMERATION_ENTRY_NODE_HANDLE* _enumerationEntryNodeHandle) {
362 m_backendHandle, value, _enumerationEntryNodeHandle);
363 });
364
365 if(enumerationEntryNodeHandle == nullptr)
366 {
367 return nullptr;
368 }
369
370 auto nodeHandle = QueryNumericFromCInterfaceFunction<PEAK_NODE_HANDLE>([&](PEAK_NODE_HANDLE* _nodeHandle) {
371 return PEAK_C_ABI_PREFIX PEAK_EnumerationEntryNode_ToNode(enumerationEntryNodeHandle, _nodeHandle);
372 });
373
374 auto nodeName = GetNodeName(nodeHandle);
375
376 return std::dynamic_pointer_cast<EnumerationEntryNode>(ParentNodeMap()->FindNode(nodeName));
377}
378
379inline std::vector<std::shared_ptr<EnumerationEntryNode>> EnumerationNode::Entries() const
380{
381 auto numEntries = QueryNumericFromCInterfaceFunction<size_t>([&](size_t* _numEntries) {
382 return PEAK_C_ABI_PREFIX PEAK_EnumerationNode_GetNumEntries(m_backendHandle, _numEntries);
383 });
384
385 std::vector<std::shared_ptr<EnumerationEntryNode>> entries;
386 for (size_t x = 0; x < numEntries; ++x)
387 {
388 auto enumerationEntryNodeHandle = QueryNumericFromCInterfaceFunction<PEAK_ENUMERATION_ENTRY_NODE_HANDLE>(
389 [&](PEAK_ENUMERATION_ENTRY_NODE_HANDLE* _enumerationEntryNodeHandle) {
391 m_backendHandle, x, _enumerationEntryNodeHandle);
392 });
393
394 auto nodeHandle = QueryNumericFromCInterfaceFunction<PEAK_NODE_HANDLE>(
395 [&](PEAK_NODE_HANDLE* _nodeHandle) {
397 enumerationEntryNodeHandle, _nodeHandle);
398 });
399
400 auto nodeName = GetNodeName(nodeHandle);
401
402 entries.emplace_back(std::dynamic_pointer_cast<EnumerationEntryNode>(ParentNodeMap()->FindNode(nodeName)));
403 }
404
405 return entries;
406}
407
408inline std::vector<std::shared_ptr<EnumerationEntryNode>> EnumerationNode::AvailableEntries() const
409{
410 const auto& entries = Entries();
411 std::vector<std::shared_ptr<EnumerationEntryNode>> availableEntries{};
412 std::copy_if(entries.begin(), entries.end(), std::back_inserter(availableEntries),
413 [](const std::shared_ptr<EnumerationEntryNode>& entry) { return entry->IsAvailable(); });
414 return availableEntries;
415}
416
417} /* namespace nodes */
418} /* namespace core */
419} /* namespace peak */
The exception thrown for passing an invalid argument to a function.
Definition peak_exception.hpp:116
EnumerationNode & operator=(const EnumerationNode &other)=delete
std::vector< std::shared_ptr< EnumerationEntryNode > > AvailableEntries() const
Returns the currently selectable entries.
Definition peak_enumeration_node.hpp:408
std::vector< std::shared_ptr< EnumerationEntryNode > > Entries() const
Returns the entries.
Definition peak_enumeration_node.hpp:379
void SetCurrentEntry(const std::shared_ptr< EnumerationEntryNode > &entry)
Sets the current entry.
Definition peak_enumeration_node.hpp:259
std::shared_ptr< EnumerationEntryNode > CurrentEntry(NodeCacheUsePolicy cacheUsePolicy=NodeCacheUsePolicy::UseCache) const
Returns the current entry.
Definition peak_enumeration_node.hpp:241
~EnumerationNode() override=default
EnumerationNode & operator=(EnumerationNode &&other)=delete
std::shared_ptr< EnumerationEntryNode > FindEntry(const std::string &symbolicValue) const
Finds an entry with the given symbolic value.
Definition peak_enumeration_node.hpp:300
bool HasEntry(const std::string &symbolicValue) const
Checks whether the enumeration node contains an entry with the given symbolic value.
Definition peak_enumeration_node.hpp:285
static constexpr auto NodeType
Definition peak_enumeration_node.hpp:42
EnumerationNode(EnumerationNode &&other)=delete
std::string NodeDataType
Definition peak_enumeration_node.hpp:43
EnumerationNode(const EnumerationNode &other)=delete
std::shared_ptr< EnumerationEntryNode > TryFindEntry(const std::string &symbolicValue) const
Tries to find an entry with the given symbolic value.
Definition peak_enumeration_node.hpp:335
std::false_type NodeHasRange
Definition peak_enumeration_node.hpp:44
std::shared_ptr< NodeMap > ParentNodeMap() const
Returns the parent node map.
Definition peak_node.hpp:939
NodeCacheUsePolicy
Definition peak_common_node_enums.hpp:26
@ Enumeration
Definition peak_node.hpp:99
@ UseCache
Definition peak_common_node_enums.hpp:27
The "nodes" namespace contains all GenAPI node types.
Definition peak_boolean_node.hpp:26
std::string GetNodeName(PEAK_NODE_HANDLE nodeHandle)
Definition peak_node.hpp:626
The "core" namespace contains the direct GenAPI and GenTL wrapper.
Definition peak_buffer.hpp:34
The "peak" namespace directly contains convenience functionality like the DeviceManager as well as th...
Definition peak_dynamic_loader.h:33
PEAK_C_API PEAK_EnumerationNode_FindEntryByValue(PEAK_ENUMERATION_NODE_HANDLE enumerationNodeHandle, int64_t value, PEAK_ENUMERATION_ENTRY_NODE_HANDLE *enumerationEntryNodeHandle)
Tells the given enumeration node to find an entry with the given value.
PEAK_C_API PEAK_EnumerationNode_GetHasEntryByValue(PEAK_ENUMERATION_NODE_HANDLE enumerationNodeHandle, int64_t value, PEAK_BOOL8 *hasEntry)
Asks the given enumeration node whether it has an entry with the given value.
PEAK_C_API PEAK_EnumerationNode_SetCurrentEntryByValue(PEAK_ENUMERATION_NODE_HANDLE enumerationNodeHandle, int64_t value)
Tells the given enumeration node to set its current entry by the given value.
PEAK_C_API PEAK_EnumerationNode_ToNode(PEAK_ENUMERATION_NODE_HANDLE enumerationNodeHandle, PEAK_NODE_HANDLE *nodeHandle)
Casts the given enumeration node to a node.
struct PEAK_ENUMERATION_NODE * PEAK_ENUMERATION_NODE_HANDLE
Definition peak_backend.h:461
PEAK_C_API PEAK_EnumerationEntryNode_ToNode(PEAK_ENUMERATION_ENTRY_NODE_HANDLE enumerationEntryNodeHandle, PEAK_NODE_HANDLE *nodeHandle)
Casts the given enumeration entry node to a node.
struct PEAK_NODE * PEAK_NODE_HANDLE
Definition peak_backend.h:429
PEAK_C_API PEAK_EnumerationNode_GetCurrentEntry(PEAK_ENUMERATION_NODE_HANDLE enumerationNodeHandle, PEAK_NODE_CACHE_USE_POLICY cacheUsePolicy, PEAK_ENUMERATION_ENTRY_NODE_HANDLE *enumerationEntryNodeHandle)
Asks the given enumeration node for its current entry.
int32_t PEAK_NODE_CACHE_USE_POLICY
Definition peak_backend.h:242
PEAK_C_API PEAK_EnumerationNode_TryFindEntryByValue(PEAK_ENUMERATION_NODE_HANDLE enumerationNodeHandle, int64_t value, PEAK_ENUMERATION_ENTRY_NODE_HANDLE *enumerationEntryNodeHandle)
Tells the given enumeration node to try to find an entry with the given value.
PEAK_C_API PEAK_EnumerationNode_GetHasEntryBySymbolicValue(PEAK_ENUMERATION_NODE_HANDLE enumerationNodeHandle, const char *symbolicValue, size_t symbolicValueSize, PEAK_BOOL8 *hasEntry)
Asks the given enumeration node whether it has an entry with the given symbolic value.
PEAK_C_API PEAK_EnumerationNode_SetCurrentEntry(PEAK_ENUMERATION_NODE_HANDLE enumerationNodeHandle, PEAK_ENUMERATION_ENTRY_NODE_HANDLE enumerationEntryNodeHandle)
Tells the given enumeration node to set its current entry to the given entry.
int8_t PEAK_BOOL8
Definition peak_backend.h:43
PEAK_C_API PEAK_EnumerationNode_GetEntry(PEAK_ENUMERATION_NODE_HANDLE enumerationNodeHandle, size_t index, PEAK_ENUMERATION_ENTRY_NODE_HANDLE *enumerationEntryNodeHandle)
Asks the given enumeration node for the entry with the given index.
struct PEAK_ENUMERATION_ENTRY_NODE * PEAK_ENUMERATION_ENTRY_NODE_HANDLE
Definition peak_backend.h:465
PEAK_C_API PEAK_EnumerationNode_FindEntryBySymbolicValue(PEAK_ENUMERATION_NODE_HANDLE enumerationNodeHandle, const char *symbolicValue, size_t symbolicValueSize, PEAK_ENUMERATION_ENTRY_NODE_HANDLE *enumerationEntryNodeHandle)
Tells the given enumeration node to find an entry with the given symbolic value.
PEAK_C_API PEAK_EnumerationNode_GetNumEntries(PEAK_ENUMERATION_NODE_HANDLE enumerationNodeHandle, size_t *numEntries)
Asks the given enumeration node for its number of entries.
PEAK_C_API PEAK_EnumerationNode_TryFindEntryBySymbolicValue(PEAK_ENUMERATION_NODE_HANDLE enumerationNodeHandle, const char *symbolicValue, size_t symbolicValueSize, PEAK_ENUMERATION_ENTRY_NODE_HANDLE *enumerationEntryNodeHandle)
Tells the given enumeration node to try to find an entry with the given symbolic value.
PEAK_C_API PEAK_EnumerationNode_SetCurrentEntryBySymbolicValue(PEAK_ENUMERATION_NODE_HANDLE enumerationNodeHandle, const char *symbolicValue, size_t symbolicValueSize)
Tells the given enumeration node to set its current entry by the given symbolic value.
#define PEAK_C_ABI_PREFIX
Definition peak_dll_defines.h:16