libt2n: (gerd) doxygenize
[libt2n] / src / connection.cpp
1 /***************************************************************************
2  *   Copyright (C) 2006 by Gerd v. Egidy                                   *
3  *   gve@intra2net.com                                                     *
4  *                                                                         *
5  *   This library is free software; you can redistribute it and/or modify  *
6  *   it under the terms of the GNU Lesser General Public License version   *
7  *   2.1 as published by the Free Software Foundation.                     *
8  *                                                                         *
9  *   This library is distributed in the hope that it will be useful,       *
10  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
11  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
12  *   GNU Lesser General Public License for more details.                   *
13  *                                                                         *
14  *   You should have received a copy of the GNU Lesser General Public      *
15  *   License along with this program; if not, write to the                 *
16  *   Free Software Foundation, Inc.,                                       *
17  *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
18  ***************************************************************************/
19
20 #include <string>
21 #include <sstream>
22
23 #include "connection.hxx"
24
25 namespace libt2n
26 {
27
28 connection::packet_size_indicator connection::bytes_available()
29 {
30     // max packet size is unsigned int
31
32     // no size information -> no packet
33     if (buffer.size() < sizeof(unsigned int))
34         return 0;
35
36     packet_size_indicator psize=*((packet_size_indicator*)(buffer.data()));
37
38     // enough data for one packet in buffer?
39     if (buffer.size() < sizeof(unsigned int)+psize)
40         return 0;
41
42     // ok, full packet there
43     return psize;
44 }
45
46 /** @brief read a complete data packet from the buffer. The packet is removed from the
47             connection buffer.
48     @param[out] data the data package
49     @retval true if packet found
50 */
51 bool connection::get_packet(std::string& data)
52 {
53     packet_size_indicator psize;
54
55     if ((psize=bytes_available()))
56     {
57         data.assign(buffer,sizeof(unsigned int),psize);
58         buffer.erase(0,sizeof(unsigned int)+psize);
59         return true;
60     }
61     else
62         return false;
63 }
64
65 /// send a blob to the peer
66 void connection::write(const std::string& data)
67 {
68     // prepend packet size to data
69     packet_size_indicator psize=data.size();
70     std::string send_data(data);
71     send_data.insert(0,(char*)&psize,sizeof(packet_size_indicator));
72
73     real_write(send_data);
74 }
75
76 }