28
28
/* *
29
29
* @brief A specialized client class for secure SSL/TLS connections.
30
30
*
31
- * The ` WiFiSSLClient` class extends the functionality of the ` WiFiClient` class to provide secure
31
+ * The WiFiSSLClient class extends the functionality of the WiFiClient class to provide secure
32
32
* communication over SSL/TLS protocols. It ensures encrypted and authenticated communication
33
33
* between the client and a remote server.
34
34
*/
35
35
class WiFiSSLClient : public WiFiClient {
36
36
37
37
public:
38
38
/* *
39
- * @brief Initializes objects of the ` WiFiSSLClient` class.
39
+ * @brief Initializes objects of the WiFiSSLClient class.
40
40
*/
41
41
WiFiSSLClient ();
42
42
~WiFiSSLClient ();
@@ -58,7 +58,7 @@ class WiFiSSLClient : public WiFiClient {
58
58
* @param `host` is the hostname or IP address of the server to connect to.
59
59
* `port` is the port number to connect to.
60
60
*
61
- * @return Returns 1 if the connection is successfully established, 0 otherwise.
61
+ * @return Returns `1` if the connection is successfully established, `0` otherwise.
62
62
*/
63
63
virtual int connect (const char * host, uint16_t port);
64
64
@@ -76,8 +76,8 @@ class WiFiSSLClient : public WiFiClient {
76
76
* certificate for establishing secure SSL connections.
77
77
*
78
78
* @param `int ecc508KeySlot` specifies the ECC key slot to be used for the SSL connection.
79
- * `const byte cert[]` is a pointer to the certificate data in the form of an array of bytes.
80
- * `int certLength` specifies the length of the certificate data array.
79
+ * @param `const byte cert[]` is a pointer to the certificate data in the form of an array of bytes.
80
+ * @param `int certLength` specifies the length of the certificate data array.
81
81
*/
82
82
void setEccSlot (int ecc508KeySlot, const byte cert[], int certLength);
83
83
@@ -86,19 +86,19 @@ class WiFiSSLClient : public WiFiClient {
86
86
*
87
87
* @param `b` is the byte to be sent.
88
88
*
89
- * @return size_t The number of bytes successfully written. Returns 1 if the byte
90
- * was sent successfully, or 0 if an error occurred.
89
+ * @return The number of bytes successfully written. Returns `1` if the byte
90
+ * was sent successfully, or `0` if an error occurred.
91
91
*/
92
92
virtual size_t write (uint8_t );
93
93
94
94
/* *
95
95
* @brief Writes a buffer of data to the SSL connection.
96
96
*
97
97
* @param `buf` is a pointer to the buffer containing the data to be sent.
98
- * `size` is the number of bytes to send from the buffer.
98
+ * @param `size` is the number of bytes to send from the buffer.
99
99
*
100
100
* @return Returns `size` if the data is successfully sent,
101
- * or 0 if the transmission fails or the socket is invalid.
101
+ * or `0` if the transmission fails or the socket is invalid.
102
102
*/
103
103
virtual size_t write (const uint8_t *buf, size_t size);
104
104
@@ -113,7 +113,7 @@ class WiFiSSLClient : public WiFiClient {
113
113
* @brief Reads data from the SSL connection into the receive buffer.
114
114
*
115
115
* @return Returns the number of bytes successfully read into the buffer. Returns
116
- * 0 if no data is received, or -1 if the socket is invalid or an error occurs.
116
+ * `0` if no data is received, or `-1` if the socket is invalid or an error occurs.
117
117
*/
118
118
virtual int read ();
119
119
@@ -123,7 +123,7 @@ class WiFiSSLClient : public WiFiClient {
123
123
* @param `buf` is a pointer to the buffer where the read data will be stored.
124
124
* `size` is the maximum number of bytes to read into the buffer.
125
125
*
126
- * @return The number of bytes successfully read. Returns 0 if no data is
126
+ * @return The number of bytes successfully read. Returns `0` if no data is
127
127
* available or an error occurs.
128
128
*/
129
129
virtual int read (uint8_t *buf, size_t size);
@@ -134,7 +134,7 @@ class WiFiSSLClient : public WiFiClient {
134
134
* This function queries the modem to retrieve the next byte available in the
135
135
* SSL/TLS connection, allowing the byte to remain in the buffer for future reads.
136
136
*
137
- * @return The next byte available as an integer value (0–255), or -1 if
137
+ * @return The next byte available as an integer value (0–255), or `-1` if
138
138
* the socket is invalid or no data is available.
139
139
*/
140
140
virtual int peek ();
@@ -159,7 +159,7 @@ class WiFiSSLClient : public WiFiClient {
159
159
* the modem for the connection status. It checks the validity of the socket
160
160
* before proceeding with the query.
161
161
*
162
- * @return uint8_t Returns 1 if the client is connected, 0 otherwise.
162
+ * @return Returns `1` if the client is connected, `0` otherwise.
163
163
*/
164
164
virtual uint8_t connected ();
165
165
@@ -177,7 +177,7 @@ class WiFiSSLClient : public WiFiClient {
177
177
*
178
178
* @param `WiFiSSLClient` object to compare.
179
179
*
180
- * @return `true` if both ` WiFiSSLClient` objects are equivalent (i.e., they have the same socket),
180
+ * @return `true` if both WiFiSSLClient objects are equivalent (i.e., they have the same socket),
181
181
* `false` otherwise.
182
182
*/
183
183
virtual bool operator ==(const WiFiSSLClient&);
@@ -189,7 +189,7 @@ class WiFiSSLClient : public WiFiClient {
189
189
* to determine if they are not equal, based on their underlying socket or connection.
190
190
*
191
191
* @param `whs` The WiFiSSLClient object to compare with.
192
- * @return `true` if the two ` WiFiSSLClient` objects do not represent the same connection (i.e., have different sockets),
192
+ * @return `true` if the two WiFiSSLClient objects do not represent the same connection (i.e., have different sockets),
193
193
* `false` otherwise.
194
194
*/
195
195
virtual bool operator !=(const WiFiSSLClient& whs)
@@ -203,7 +203,7 @@ class WiFiSSLClient : public WiFiClient {
203
203
* This function queries the modem for the remote IP address associated with
204
204
* the current connection.
205
205
*
206
- * @return The remote IP address of the client. Returns 0.0.0.0 if the
206
+ * @return The remote IP address of the client. Returns ` 0.0.0.0` if the
207
207
* socket is not valid or the query fails.
208
208
*/
209
209
virtual IPAddress remoteIP ();
@@ -214,25 +214,25 @@ class WiFiSSLClient : public WiFiClient {
214
214
* This function queries the modem to obtain the remote port number associated
215
215
* with the current connection.
216
216
*
217
- * @return Returns the remote port number of the client. Returns 0 if the socket
217
+ * @return Returns the remote port number of the client. Returns `0` if the socket
218
218
* is not valid or the query fails.
219
219
*/
220
220
virtual uint16_t remotePort ();
221
221
222
222
223
223
/* *
224
- * @brief Declares ` WiFiServer` as a friend class.
224
+ * @brief Declares WiFiServer as a friend class.
225
225
*
226
- * This allows the ` WiFiServer` class to access private and protected members
227
- * of the ` WiFiSSLClient` class.
226
+ * This allows the WiFiServer class to access private and protected members
227
+ * of the WiFiSSLClient class.
228
228
*/
229
229
friend class WiFiServer ;
230
230
231
231
/* *
232
- * @brief Inherits the `write` method from the ` Print` class.
232
+ * @brief Inherits the `write` method from the Print class.
233
233
*
234
- * This allows the ` WiFiSSLClient` class to use the `write` method defined in the
235
- * ` Print` class.
234
+ * This allows the WiFiSSLClient class to use the `write` method defined in the
235
+ * Print class.
236
236
*/
237
237
using Print::write;
238
238
0 commit comments