YARP
Yet Another Robot Platform
PortReaderBuffer.h
Go to the documentation of this file.
1 /*
2  * SPDX-FileCopyrightText: 2006-2021 Istituto Italiano di Tecnologia (IIT)
3  * SPDX-FileCopyrightText: 2006-2010 RobotCub Consortium
4  * SPDX-License-Identifier: BSD-3-Clause
5  */
6 
7 #ifndef YARP_OS_PORTREADERBUFFER_H
8 #define YARP_OS_PORTREADERBUFFER_H
9 
10 #include <yarp/os/Bottle.h>
11 #include <yarp/os/LocalReader.h>
12 #include <yarp/os/Port.h>
13 #include <yarp/os/PortReader.h>
16 #include <yarp/os/Thread.h>
17 #include <yarp/os/TypedReader.h>
20 
21 #include <cstdio>
22 #include <string>
23 
24 namespace yarp {
25 namespace os {
26 
35 template <typename T>
37  public yarp::os::TypedReader<T>,
38  public yarp::os::LocalReader<T>,
40 {
41 public:
47  PortReaderBuffer(unsigned int maxBuffer = 0);
48 
52  virtual ~PortReaderBuffer();
53 
54  void detach();
55 
56  // documented in TypedReader
57  void setStrict(bool strict = true) override;
58 
65  bool check();
66 
67  // documented in TypedReader
68  int getPendingReads() override;
69 
70  // documented in TypedReader
71  T* read(bool shouldWait = true) override;
72 
73  // documented in TypedReader
74  void interrupt() override;
75 
76  // documented in TypedReader
77  T* lastRead() override;
78 
86  void attach(Port& port);
87 
88  // documented in TypedReader
89  void useCallback(TypedReaderCallback<T>& callback) override;
90 
91  // documented in TypedReader
92  void disableCallback() override;
93 
101  virtual bool read(ConnectionReader& connection);
102 
111  PortReader* create() const override;
112 
113  // documented in TypedReader
114  void setReplier(PortReader& reader) override;
115 
116  virtual bool getEnvelope(PortReader& envelope);
117 
118  // documented in TypedReader
119  bool isClosed() override;
120 
121  // documented in TypedReader
122  std::string getName() const override;
123 
124  // documented in LocalReader
125  bool acceptObject(T* obj, PortWriter* wrapper) override;
126 
127  // documented in LocalReader
128  bool forgetObject(T* obj, yarp::os::PortWriter* wrapper) override;
129 
130  // documented in TypedReader
131  void* acquire() override;
132 
133  // documented in TypedReader
134  void release(void* handle) override;
135 
136  // documented in TypedReader
137  void setTargetPeriod(double period) override;
138 
139 private:
140  yarp::os::PortReaderBufferBase implementation;
141  bool autoDiscard;
142  T* last;
143  T* default_value;
144  TypedReaderThread<T>* reader;
145 };
146 
147 } // namespace os
148 } // namespace yarp
149 
151 
152 #endif // YARP_OS_PORTREADERBUFFER_H
An interface for reading from a network connection.
Under development.
Definition: LocalReader.h:19
Buffer incoming data to a port.
bool forgetObject(T *obj, yarp::os::PortWriter *wrapper) override
Sender is no longer interested in getting callbacks.
T * read(bool shouldWait=true) override
Read an available object from the port.
virtual bool getEnvelope(PortReader &envelope)
void setTargetPeriod(double period) override
Try to provide data periodically.
bool acceptObject(T *obj, PortWriter *wrapper) override
Send object obj; expect callback to wrapper when obj is no longer in use.
PortReaderBuffer(unsigned int maxBuffer=0)
Constructor.
bool isClosed() override
Returns whether the port associated with this reader has been closed.
void * acquire() override
Take control of the last object read.
PortReader * create() const override
Factory method.
bool check()
Check if data is available.
virtual ~PortReaderBuffer()
Destructor.
void attach(Port &port)
Attach this buffer to a particular port.
T * lastRead() override
Get the last data returned by read()
std::string getName() const override
Get name of port being read from.
void setStrict(bool strict=true) override
Call this to strictly keep all messages, or allow old ones to be quietly dropped.
void interrupt() override
Abort any read operation currently in progress.
void setReplier(PortReader &reader) override
If a message is received that requires a reply, use this handler.
void useCallback(TypedReaderCallback< T > &callback) override
Set an object whose onRead method will be called when data is available.
void release(void *handle) override
Return control to YARP of an object previously taken control of with the acquire() method.
int getPendingReads() override
Check how many messages are waiting to be read.
void disableCallback() override
Remove a callback set up with useCallback()
Interface implemented by all objects that can read themselves from the network, such as Bottle object...
Definition: PortReader.h:25
Interface implemented by all objects that can write themselves to the network, such as Bottle objects...
Definition: PortWriter.h:24
A mini-server for network communication.
Definition: Port.h:47
A callback for typed data from a port.
A base class for sources of typed data.
Definition: TypedReader.h:23
The main, catch-all namespace for YARP.
Definition: dirs.h:16