IDS peak genericC++  v1.4.3
peak_node_map.hpp
Go to the documentation of this file.
1 
11 #pragma once
12 
13 
15 #include <peak/dll_interface/peak_dll_interface_util.hpp>
18 
19 #include <type_traits>
20 #include <unordered_map>
21 #include <algorithm>
22 #include <cstdint>
23 #include <functional>
24 #include <iterator>
25 #include <memory>
26 #include <mutex>
27 #include <string>
28 #include <vector>
29 
30 
31 namespace peak
32 {
33 namespace core
34 {
35 namespace nodes
36 {
37 
38 class BooleanNode;
39 class CategoryNode;
40 class CommandNode;
41 class EnumerationNode;
42 class EnumerationEntryNode;
43 class FloatNode;
44 class IntegerNode;
45 class Node;
46 class RegisterNode;
47 class StringNode;
48 
49 } // namespace nodes
50 
51 class Buffer;
52 
59 class NodeMap
60  : public InitOnce
61  , public std::enable_shared_from_this<NodeMap>
62 {
63 public:
65  using NodeFilterFunction = std::function<bool(const std::shared_ptr<const nodes::Node>& nodeToFilter)>;
66 
73  {
74  public:
75  ScopedNodeMapLock() = delete;
77  ScopedNodeMapLock(const ScopedNodeMapLock& other) = delete;
78  ScopedNodeMapLock& operator=(const ScopedNodeMapLock& other) = delete;
79  ScopedNodeMapLock(ScopedNodeMapLock&& other) = delete;
80  ScopedNodeMapLock& operator=(ScopedNodeMapLock&& other) = delete;
81 
82  private:
83  friend NodeMap;
84  friend ClassCreator<ScopedNodeMapLock>;
85  explicit ScopedNodeMapLock(const std::shared_ptr<NodeMap>& nodeMap);
86  std::shared_ptr<NodeMap> m_nodeMap;
87  };
88 
89  NodeMap() = delete;
90  ~NodeMap() = default;
91  NodeMap(const NodeMap& other) = delete;
92  NodeMap& operator=(const NodeMap& other) = delete;
93  NodeMap(NodeMap&& other) = delete;
94  NodeMap& operator=(NodeMap&& other) = delete;
95 
105  bool HasNode(const std::string& name) const;
115  template <class NodeType, typename std::enable_if<std::is_base_of<nodes::Node, NodeType>::value, int>::type = 0>
116  bool HasNode(const std::string& name)
117  {
118  PEAK_NODE_HANDLE nodeHandle{ nullptr };
119  if (PEAK_C_ABI_PREFIX PEAK_NodeMap_FindNode(m_backendHandle, name.c_str(), name.size() + 1, &nodeHandle)
121  {
122  return false;
123  }
124 
125  return std::dynamic_pointer_cast<NodeType>(FindNode(name)) != nullptr;
126  }
140  std::shared_ptr<nodes::Node> FindNode(const std::string& name);
155  template <class NodeType, typename std::enable_if<std::is_base_of<nodes::Node, NodeType>::value, int>::type = 0>
156  std::shared_ptr<NodeType> FindNode(const std::string& name)
157  {
158  auto castedNode = std::dynamic_pointer_cast<NodeType>(FindNode(name));
159  if (!castedNode)
160  {
161  throw InvalidCastException("Invalid node cast!");
162  }
163 
164  return castedNode;
165  }
173  void InvalidateNodes();
183  void PollNodes(int64_t elapsedTime_ms);
193  std::vector<std::shared_ptr<nodes::Node>> Nodes() const;
204  bool HasBufferSupportedChunks(const std::shared_ptr<Buffer>& buffer) const;
218  void UpdateChunkNodes(const std::shared_ptr<Buffer>& buffer);
229  bool HasEventSupportedData(const std::unique_ptr<Event>& event) const;
243  void UpdateEventNodes(const std::unique_ptr<Event>& event);
257  void StoreToFile(const std::string& filePath) const;
271  void LoadFromFile(const std::string& filePath);
272 
291  std::unique_ptr<ScopedNodeMapLock> Lock();
292 
293 private:
294  std::shared_ptr<nodes::Node> NodeFromHandle(PEAK_NODE_HANDLE nodeHandle) const;
295 
296  friend ClassCreator<NodeMap>;
297  explicit NodeMap(PEAK_NODE_MAP_HANDLE nodeMapHandle);
298  PEAK_NODE_MAP_HANDLE m_backendHandle;
299 
300  void Initialize() const override;
301  mutable std::vector<std::shared_ptr<nodes::Node>> m_nodes;
302  mutable std::unordered_map<std::string, std::shared_ptr<nodes::Node>> m_nodesByName;
303 };
304 
305 } /* namespace core */
306 } /* namespace peak */
307 
318 
319 
320 /* Implementation */
321 namespace peak
322 {
323 namespace core
324 {
325 
326 inline NodeMap::NodeMap(PEAK_NODE_MAP_HANDLE nodeMapHandle)
327  : m_backendHandle(nodeMapHandle)
328  , m_nodes()
329  , m_nodesByName()
330 {}
331 
332 inline bool NodeMap::HasNode(const std::string& name) const
333 {
334  return QueryNumericFromCInterfaceFunction<PEAK_BOOL8>([&](PEAK_BOOL8* hasNode) {
335  return PEAK_C_ABI_PREFIX PEAK_NodeMap_GetHasNode(m_backendHandle, name.c_str(), name.size() + 1, hasNode);
336  }) > 0;
337 }
338 
339 inline std::shared_ptr<nodes::Node> NodeMap::FindNode(const std::string& name)
340 {
341  InitializeIfNecessary();
342 
343  (void)QueryNumericFromCInterfaceFunction<PEAK_NODE_HANDLE>([&](PEAK_NODE_HANDLE* nodeHandle) {
345  m_backendHandle, name.c_str(), name.size() + 1, nodeHandle);
346  });
347 
348  return m_nodesByName.at(name);
349 }
350 
352 {
353  CallAndCheckCInterfaceFunction(
354  [&] { return PEAK_C_ABI_PREFIX PEAK_NodeMap_InvalidateNodes(m_backendHandle); });
355 }
356 
357 inline void NodeMap::PollNodes(int64_t elapsedTime_ms)
358 {
359  CallAndCheckCInterfaceFunction(
360  [&] { return PEAK_C_ABI_PREFIX PEAK_NodeMap_PollNodes(m_backendHandle, elapsedTime_ms); });
361 }
362 
363 inline std::vector<std::shared_ptr<nodes::Node>> NodeMap::Nodes() const
364 {
365  InitializeIfNecessary();
366 
367  return m_nodes;
368 }
369 
370 inline bool NodeMap::HasEventSupportedData(const std::unique_ptr<Event>& event) const
371 {
372  if (event == nullptr)
373  {
374  throw InvalidArgumentException("The given event is a nullptr!");
375  }
376 
377  return QueryNumericFromCInterfaceFunction<PEAK_BOOL8>([&](PEAK_BOOL8* hasSupportedData) {
379  m_backendHandle, event->m_backendHandle, hasSupportedData);
380  }) > 0;
381 }
382 
383 inline void NodeMap::UpdateEventNodes(const std::unique_ptr<Event>& event)
384 {
385  if (event == nullptr)
386  {
387  throw InvalidArgumentException("The given event is a nullptr!");
388  }
389 
390  CallAndCheckCInterfaceFunction(
391  [&] { return PEAK_C_ABI_PREFIX PEAK_NodeMap_UpdateEventNodes(m_backendHandle, event->m_backendHandle); });
392 }
393 
394 inline void NodeMap::StoreToFile(const std::string& filePath) const
395 {
396  CallAndCheckCInterfaceFunction([&] {
397  return PEAK_C_ABI_PREFIX PEAK_NodeMap_StoreToFile(m_backendHandle, filePath.c_str(), filePath.size() + 1);
398  });
399 }
400 
401 inline void NodeMap::LoadFromFile(const std::string& filePath)
402 {
403  InitializeIfNecessary();
404 
405  CallAndCheckCInterfaceFunction([&] {
407  m_backendHandle, filePath.c_str(), filePath.size() + 1);
408  });
409 }
410 
411 inline NodeMap::ScopedNodeMapLock::ScopedNodeMapLock(const std::shared_ptr<NodeMap>& nodeMap)
412  : m_nodeMap(nodeMap)
413 {
414  CallAndCheckCInterfaceFunction(
415  [&] { return PEAK_C_ABI_PREFIX PEAK_NodeMap_Lock(m_nodeMap->m_backendHandle); });
416 }
418 {
419  CallAndCheckCInterfaceFunction(
420  [&] { return PEAK_C_ABI_PREFIX PEAK_NodeMap_Unlock(m_nodeMap->m_backendHandle); });
421 }
422 
423 inline std::unique_ptr<NodeMap::ScopedNodeMapLock> NodeMap::Lock()
424 {
425  return std::make_unique<ClassCreator<ScopedNodeMapLock>>(shared_from_this());
426 }
427 
428 inline std::shared_ptr<nodes::Node> NodeMap::NodeFromHandle(PEAK_NODE_HANDLE nodeHandle) const
429 {
430  auto nodeType = QueryNumericFromCInterfaceFunction<PEAK_NODE_TYPE>(
431  [&](PEAK_NODE_TYPE* _nodeType) { return PEAK_C_ABI_PREFIX PEAK_Node_GetType(nodeHandle, _nodeType); });
432 
433  switch (nodeType)
434  {
435  case PEAK_NODE_TYPE_INTEGER: {
436  auto integerNodeHandle = QueryNumericFromCInterfaceFunction<PEAK_INTEGER_NODE_HANDLE>(
437  [&](PEAK_INTEGER_NODE_HANDLE* _integerNodeHandle) {
438  return PEAK_C_ABI_PREFIX PEAK_Node_ToIntegerNode(nodeHandle, _integerNodeHandle);
439  });
440 
441  return std::make_shared<ClassCreator<nodes::IntegerNode>>(
442  integerNodeHandle, std::const_pointer_cast<core::NodeMap>(shared_from_this()));
443  }
444  case PEAK_NODE_TYPE_BOOLEAN: {
445  auto booleanNodeHandle = QueryNumericFromCInterfaceFunction<PEAK_BOOLEAN_NODE_HANDLE>(
446  [&](PEAK_BOOLEAN_NODE_HANDLE* _booleanNodeHandle) {
447  return PEAK_C_ABI_PREFIX PEAK_Node_ToBooleanNode(nodeHandle, _booleanNodeHandle);
448  });
449 
450  return std::make_shared<ClassCreator<nodes::BooleanNode>>(
451  booleanNodeHandle, std::const_pointer_cast<core::NodeMap>(shared_from_this()));
452  }
453  case PEAK_NODE_TYPE_COMMAND: {
454  auto commandNodeHandle = QueryNumericFromCInterfaceFunction<PEAK_COMMAND_NODE_HANDLE>(
455  [&](PEAK_COMMAND_NODE_HANDLE* _commandNodeHandle) {
456  return PEAK_C_ABI_PREFIX PEAK_Node_ToCommandNode(nodeHandle, _commandNodeHandle);
457  });
458 
459  return std::make_shared<ClassCreator<nodes::CommandNode>>(
460  commandNodeHandle, std::const_pointer_cast<core::NodeMap>(shared_from_this()));
461  }
462  case PEAK_NODE_TYPE_FLOAT: {
463  auto floatNodeHandle = QueryNumericFromCInterfaceFunction<PEAK_FLOAT_NODE_HANDLE>(
464  [&](PEAK_FLOAT_NODE_HANDLE* _floatNodeHandle) {
465  return PEAK_C_ABI_PREFIX PEAK_Node_ToFloatNode(nodeHandle, _floatNodeHandle);
466  });
467 
468  return std::make_shared<ClassCreator<nodes::FloatNode>>(
469  floatNodeHandle, std::const_pointer_cast<core::NodeMap>(shared_from_this()));
470  }
471  case PEAK_NODE_TYPE_STRING: {
472  auto stringNodeHandle = QueryNumericFromCInterfaceFunction<PEAK_STRING_NODE_HANDLE>(
473  [&](PEAK_STRING_NODE_HANDLE* _stringNodeHandle) {
474  return PEAK_C_ABI_PREFIX PEAK_Node_ToStringNode(nodeHandle, _stringNodeHandle);
475  });
476 
477  return std::make_shared<ClassCreator<nodes::StringNode>>(
478  stringNodeHandle, std::const_pointer_cast<core::NodeMap>(shared_from_this()));
479  }
481  auto registerNodeHandle = QueryNumericFromCInterfaceFunction<PEAK_REGISTER_NODE_HANDLE>(
482  [&](PEAK_REGISTER_NODE_HANDLE* _registerNodeHandle) {
483  return PEAK_C_ABI_PREFIX PEAK_Node_ToRegisterNode(nodeHandle, _registerNodeHandle);
484  });
485 
486  return std::make_shared<ClassCreator<nodes::RegisterNode>>(
487  registerNodeHandle, std::const_pointer_cast<core::NodeMap>(shared_from_this()));
488  }
490  auto categoryNodeHandle = QueryNumericFromCInterfaceFunction<PEAK_CATEGORY_NODE_HANDLE>(
491  [&](PEAK_CATEGORY_NODE_HANDLE* _categoryNodeHandle) {
492  return PEAK_C_ABI_PREFIX PEAK_Node_ToCategoryNode(nodeHandle, _categoryNodeHandle);
493  });
494 
495  return std::make_shared<ClassCreator<nodes::CategoryNode>>(
496  categoryNodeHandle, std::const_pointer_cast<core::NodeMap>(shared_from_this()));
497  }
499  auto enumerationNodeHandle = QueryNumericFromCInterfaceFunction<PEAK_ENUMERATION_NODE_HANDLE>(
500  [&](PEAK_ENUMERATION_NODE_HANDLE* _enumerationNodeHandle) {
501  return PEAK_C_ABI_PREFIX PEAK_Node_ToEnumerationNode(nodeHandle, _enumerationNodeHandle);
502  });
503 
504  return std::make_shared<ClassCreator<nodes::EnumerationNode>>(
505  enumerationNodeHandle, std::const_pointer_cast<core::NodeMap>(shared_from_this()));
506  }
508  auto enumerationEntryNodeHandle = QueryNumericFromCInterfaceFunction<PEAK_ENUMERATION_ENTRY_NODE_HANDLE>(
509  [&](PEAK_ENUMERATION_ENTRY_NODE_HANDLE* _enumerationEntryNodeHandle) {
511  nodeHandle, _enumerationEntryNodeHandle);
512  });
513 
514  return std::make_shared<ClassCreator<nodes::EnumerationEntryNode>>(
515  enumerationEntryNodeHandle, std::const_pointer_cast<core::NodeMap>(shared_from_this()));
516  }
517  default: {
518  return std::make_shared<ClassCreator<nodes::Node>>(
519  nodeHandle, std::const_pointer_cast<core::NodeMap>(shared_from_this()));
520  }
521  }
522 }
523 
524 inline void NodeMap::Initialize() const
525 {
526  auto numNodes = QueryNumericFromCInterfaceFunction<size_t>([&](size_t* _numNodes) {
527  return PEAK_C_ABI_PREFIX PEAK_NodeMap_GetNumNodes(m_backendHandle, _numNodes);
528  });
529 
530  for (size_t x = 0; x < numNodes; ++x)
531  {
532  auto nodeHandle = QueryNumericFromCInterfaceFunction<PEAK_NODE_HANDLE>(
533  [&](PEAK_NODE_HANDLE* _nodeHandle) {
534  return PEAK_C_ABI_PREFIX PEAK_NodeMap_GetNode(m_backendHandle, x, _nodeHandle);
535  });
536 
537  auto node = NodeFromHandle(nodeHandle);
538 
539  m_nodes.emplace_back(node);
540  m_nodesByName.emplace(node->Name(), node);
541  }
542 }
543 
544 } /* namespace core */
545 } /* namespace peak */
Represents a GenAPI node map.
Definition: peak_node_map.hpp:59
Definition: peak_backend.h:272
bool HasEventSupportedData(const std::unique_ptr< Event > &event) const
Checks if the Event contains data corresponding to the NodeMap.
Definition: peak_node_map.hpp:370
std::vector< std::shared_ptr< nodes::Node > > Nodes() const
Returns the nodes.
Definition: peak_node_map.hpp:363
The exception thrown for pass an invalid argument to a function.
Definition: peak_exception.hpp:73
int8_t PEAK_BOOL8
Definition: peak_backend.h:26
std::unique_ptr< ScopedNodeMapLock > Lock()
Locks a recursive mutex on the NodeMap.
Definition: peak_node_map.hpp:423
Definition: peak_backend.h:277
Holds a recursive lock on the NodeMap.
Definition: peak_node_map.hpp:72
PEAK_C_API PEAK_Node_ToEnumerationEntryNode(PEAK_NODE_HANDLE nodeHandle, PEAK_ENUMERATION_ENTRY_NODE_HANDLE *enumerationEntryNodeHandle)
Casts the given node to an enumeration entry node.
int32_t PEAK_NODE_TYPE
Definition: peak_backend.h:279
The "peak" namespace directly contains convenience functionality like the DeviceManager as well as th...
Definition: peak_dynamic_loader.h:32
Definition: peak_backend.h:270
The exception thrown for trying to apply an invalid cast.
Definition: peak_exception.hpp:81
struct PEAK_INTEGER_NODE * PEAK_INTEGER_NODE_HANDLE
Definition: peak_backend.h:413
void InvalidateNodes()
Invalidates all nodes.
Definition: peak_node_map.hpp:351
struct PEAK_CATEGORY_NODE * PEAK_CATEGORY_NODE_HANDLE
Definition: peak_backend.h:437
PEAK_C_API PEAK_NodeMap_GetNumNodes(PEAK_NODE_MAP_HANDLE nodeMapHandle, size_t *numNodes)
Asks the given node map for its number of nodes.
PEAK_C_API PEAK_Node_ToRegisterNode(PEAK_NODE_HANDLE nodeHandle, PEAK_REGISTER_NODE_HANDLE *registerNodeHandle)
Casts the given node to a register node.
~ScopedNodeMapLock()
Definition: peak_node_map.hpp:417
PEAK_C_API PEAK_Node_ToCommandNode(PEAK_NODE_HANDLE nodeHandle, PEAK_COMMAND_NODE_HANDLE *commandNodeHandle)
Casts the given node to a command node.
PEAK_C_API PEAK_NodeMap_PollNodes(PEAK_NODE_MAP_HANDLE nodeMapHandle, int64_t elapsedTime_ms)
Tells the given node map to poll its nodes.
struct PEAK_NODE * PEAK_NODE_HANDLE
Definition: peak_backend.h:409
PEAK_C_API PEAK_NodeMap_UpdateEventNodes(PEAK_NODE_MAP_HANDLE nodeMapHandle, PEAK_EVENT_HANDLE eventHandle)
Updates event information in the node map.
void PollNodes(int64_t elapsedTime_ms)
Polls all nodes having a polling time.
Definition: peak_node_map.hpp:357
PEAK_C_API PEAK_Node_ToEnumerationNode(PEAK_NODE_HANDLE nodeHandle, PEAK_ENUMERATION_NODE_HANDLE *enumerationNodeHandle)
Casts the given node to an enumeration node.
struct PEAK_NODE_MAP * PEAK_NODE_MAP_HANDLE
Definition: peak_backend.h:405
std::shared_ptr< NodeType > FindNode(const std::string &name)
Tries to find a node with the given name and type.
Definition: peak_node_map.hpp:156
struct PEAK_ENUMERATION_ENTRY_NODE * PEAK_ENUMERATION_ENTRY_NODE_HANDLE
Definition: peak_backend.h:445
PEAK_C_API PEAK_NodeMap_LoadFromFile(PEAK_NODE_MAP_HANDLE nodeMapHandle, const char *filePath, size_t filePathSize)
Tells the given node map to load the values of its streamable nodes from a file at the given file pat...
Definition: peak_backend.h:274
PEAK_C_API PEAK_Node_ToIntegerNode(PEAK_NODE_HANDLE nodeHandle, PEAK_INTEGER_NODE_HANDLE *integerNodeHandle)
Casts the given node to an integer node.
struct PEAK_ENUMERATION_NODE * PEAK_ENUMERATION_NODE_HANDLE
Definition: peak_backend.h:441
Definition: peak_backend.h:275
PEAK_C_API PEAK_NodeMap_Lock(PEAK_NODE_MAP_HANDLE nodeMapHandle)
Locks a recursive mutex on the NodeMap.
Definition: peak_backend.h:271
struct PEAK_BOOLEAN_NODE * PEAK_BOOLEAN_NODE_HANDLE
Definition: peak_backend.h:417
PEAK_C_API PEAK_Node_GetType(PEAK_NODE_HANDLE nodeHandle, PEAK_NODE_TYPE *type)
Asks the given node for its type.
Definition: peak_backend.h:317
struct PEAK_STRING_NODE * PEAK_STRING_NODE_HANDLE
Definition: peak_backend.h:429
bool HasNode(const std::string &name) const
Checks whether the node map contains a node with the given name.
Definition: peak_node_map.hpp:332
Definition: peak_backend.h:269
Definition: peak_backend.h:273
NodeType
Definition: peak_node.hpp:86
PEAK_C_API PEAK_NodeMap_GetNode(PEAK_NODE_MAP_HANDLE nodeMapHandle, size_t index, PEAK_NODE_HANDLE *nodeHandle)
Asks the given node map for the node with the given index.
PEAK_C_API PEAK_NodeMap_GetHasNode(PEAK_NODE_MAP_HANDLE nodeMapHandle, const char *nodeName, size_t nodeNameSize, PEAK_BOOL8 *hasNode)
Checks whether the given node map contains a node with the given name.
struct PEAK_FLOAT_NODE * PEAK_FLOAT_NODE_HANDLE
Definition: peak_backend.h:425
bool HasNode(const std::string &name)
Checks whether the node map contains a node with the given name and type.
Definition: peak_node_map.hpp:116
#define PEAK_C_ABI_PREFIX
Definition: peak_dll_defines.h:16
PEAK_C_API PEAK_NodeMap_StoreToFile(PEAK_NODE_MAP_HANDLE nodeMapHandle, const char *filePath, size_t filePathSize)
Tells the given node map to store the values of its streamable nodes to a file at the given file path...
std::shared_ptr< nodes::Node > FindNode(const std::string &name)
Tries to find a node with the given name.
Definition: peak_node_map.hpp:339
PEAK_C_API PEAK_NodeMap_Unlock(PEAK_NODE_MAP_HANDLE nodeMapHandle)
Unlocks the recursive mutex on the NodeMap.
Definition: peak_backend.h:276
PEAK_C_API PEAK_Node_ToFloatNode(PEAK_NODE_HANDLE nodeHandle, PEAK_FLOAT_NODE_HANDLE *floatNodeHandle)
Casts the given node to a float node.
std::function< bool(const std::shared_ptr< const nodes::Node > &nodeToFilter)> NodeFilterFunction
Definition: peak_node_map.hpp:65
PEAK_C_API PEAK_Node_ToBooleanNode(PEAK_NODE_HANDLE nodeHandle, PEAK_BOOLEAN_NODE_HANDLE *booleanNodeHandle)
Casts the given node to a boolean node.
PEAK_C_API PEAK_NodeMap_InvalidateNodes(PEAK_NODE_MAP_HANDLE nodeMapHandle)
Tells the given node map to invalidate its nodes.
void UpdateEventNodes(const std::unique_ptr< Event > &event)
Updates event information in the NodeMap.
Definition: peak_node_map.hpp:383
void StoreToFile(const std::string &filePath) const
Stores the values of streamable nodes to the file at the given file path.
Definition: peak_node_map.hpp:394
PEAK_C_API PEAK_NodeMap_GetHasEventSupportedData(PEAK_NODE_MAP_HANDLE nodeMapHandle, PEAK_EVENT_HANDLE eventHandle, PEAK_BOOL8 *hasSupportedData)
Checks if the event contains data corresponding to the node map.
void LoadFromFile(const std::string &filePath)
Loads the values of streamable nodes from the file at the given file path.
Definition: peak_node_map.hpp:401
struct PEAK_COMMAND_NODE * PEAK_COMMAND_NODE_HANDLE
Definition: peak_backend.h:421
PEAK_C_API PEAK_NodeMap_FindNode(PEAK_NODE_MAP_HANDLE nodeMapHandle, const char *nodeName, size_t nodeNameSize, PEAK_NODE_HANDLE *nodeHandle)
Tells the given node map to find a node with the given name.
PEAK_C_API PEAK_Node_ToCategoryNode(PEAK_NODE_HANDLE nodeHandle, PEAK_CATEGORY_NODE_HANDLE *categoryNodeHandle)
Casts the given node to a category node.
struct PEAK_REGISTER_NODE * PEAK_REGISTER_NODE_HANDLE
Definition: peak_backend.h:433
PEAK_C_API PEAK_Node_ToStringNode(PEAK_NODE_HANDLE nodeHandle, PEAK_STRING_NODE_HANDLE *stringNodeHandle)
Casts the given node to a string node.