+ return bt2_message._create_from_ptr(msg_ptr)
+
+ def can_seek_beginning(self):
+ (status, res) = native_bt.message_iterator_can_seek_beginning(self._ptr)
+ bt2_utils._handle_func_status(
+ status,
+ "cannot check whether or not message iterator can seek its beginning",
+ )
+ return res != 0
+
+ def seek_beginning(self):
+ # Forget about buffered messages, they won't be valid after seeking.
+ self._current_msgs.clear()
+ self._at = 0
+
+ status = native_bt.message_iterator_seek_beginning(self._ptr)
+ bt2_utils._handle_func_status(status, "cannot seek message iterator beginning")
+
+ def can_seek_ns_from_origin(self, ns_from_origin):
+ bt2_utils._check_int64(ns_from_origin)
+ (status, res) = native_bt.message_iterator_can_seek_ns_from_origin(
+ self._ptr, ns_from_origin
+ )
+ bt2_utils._handle_func_status(
+ status,
+ "cannot check whether or not message iterator can seek given ns from origin",
+ )
+ return res != 0
+
+ def seek_ns_from_origin(self, ns_from_origin):
+ bt2_utils._check_int64(ns_from_origin)
+
+ # Forget about buffered messages, they won't be valid after seeking.
+ self._current_msgs.clear()
+ self._at = 0
+
+ status = native_bt.message_iterator_seek_ns_from_origin(
+ self._ptr, ns_from_origin
+ )
+ bt2_utils._handle_func_status(
+ status, "message iterator cannot seek given ns from origin"
+ )