Gazebo Transport

API Reference

11.4.1
gz/transport/log/Log.hh
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2018 Open Source Robotics Foundation
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  * http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  *
16 */
17 
18 #ifndef GZ_TRANSPORT_LOG_LOG_HH_
19 #define GZ_TRANSPORT_LOG_LOG_HH_
20 
21 #include <chrono>
22 #include <ios>
23 #include <memory>
24 #include <string>
25 
26 #include <gz/transport/config.hh>
30 #include <gz/transport/log/Export.hh>
31 
33 {
34  // Inline bracket to help doxygen filtering.
35  inline namespace IGNITION_TRANSPORT_VERSION_NAMESPACE {
36  //
38  const std::string SchemaLocationEnvVar = "IGN_TRANSPORT_LOG_SQL_PATH";
39 
41  class IGNITION_TRANSPORT_LOG_VISIBLE Log
42  {
44  public: Log();
45 
48  public: Log(Log &&_old); // NOLINT
49 
51  public: ~Log();
52 
55  public: bool Valid() const;
56 
60  public: std::string Version() const;
61 
68  public: bool Open(const std::string &_file,
69  std::ios_base::openmode _mode = std::ios_base::in);
70 
74  public: std::string Filename() const;
75 
81  public: const log::Descriptor *Descriptor() const;
82 
90  public: bool InsertMessage(
91  const std::chrono::nanoseconds &_time,
92  const std::string &_topic, const std::string &_type,
93  const void *_data, std::size_t _len);
94 
100  public: Batch QueryMessages(
101  const QueryOptions &_options = AllTopics());
102 
107  public: std::chrono::nanoseconds StartTime() const;
108 
113  public: std::chrono::nanoseconds EndTime() const;
114 
116  private: class Implementation;
117 
118 #ifdef _WIN32
119 // Disable warning C4251 which is triggered by
120 // std::*
121 #pragma warning(push)
122 #pragma warning(disable: 4251)
123 #endif
124  private: std::unique_ptr<Implementation> dataPtr;
126 #ifdef _WIN32
127 #pragma warning(pop)
128 #endif
129  };
130  }
131 }
132 #endif
STL class.
Holds the result of a query for messages.
Definition: gz/transport/log/Batch.hh:37
Interface to a log file.
Definition: gz/transport/log/Log.hh:41
Query for all the topics.
Definition: gz/transport/log/QueryOptions.hh:258
const std::string SchemaLocationEnvVar
Name of Environment variable containing path to schema.
Definition: gz/transport/log/Log.hh:38
The Descriptor class provides meta-information about what a log contains. This may be useful for dete...
Definition: gz/transport/log/Descriptor.hh:41
Definition: gz/transport/log/Batch.hh:27
The QueryOptions interface is used by Log::QueryMessages() to determine which messages are retrieved ...
Definition: gz/transport/log/QueryOptions.hh:41