ascii-chat 0.6.0
Real-time terminal-based video chat with ASCII art conversion
Loading...
Searching...
No Matches
Functions
parsing.c File Reference
Utility Functions

🔍 Safe string parsing utilities for integers, sizes, and protocol messages More...

Go to the source code of this file.

Functions

asciichat_error_t safe_parse_size_message (const char *message, unsigned int *width, unsigned int *height)
 Parse SIZE message format.
 
asciichat_error_t safe_parse_audio_message (const char *message, unsigned int *num_samples)
 Parse AUDIO message format.
 
asciichat_error_t parse_long (const char *str, long *out_value, long min_value, long max_value)
 Parse signed long integer with range validation.
 
asciichat_error_t parse_ulong (const char *str, unsigned long *out_value, unsigned long min_value, unsigned long max_value)
 Parse unsigned long integer with range validation.
 
asciichat_error_t parse_ulonglong (const char *str, unsigned long long *out_value, unsigned long long min_value, unsigned long long max_value)
 Parse unsigned long long integer with range validation.
 
asciichat_error_t parse_port (const char *str, uint16_t *out_port)
 Parse port number (1-65535) from string.
 
asciichat_error_t parse_int32 (const char *str, int32_t *out_value, int32_t min_value, int32_t max_value)
 Parse signed 32-bit integer with range validation.
 
asciichat_error_t parse_uint32 (const char *str, uint32_t *out_value, uint32_t min_value, uint32_t max_value)
 Parse unsigned 32-bit integer with range validation.
 

Detailed Description

🔍 Safe string parsing utilities for integers, sizes, and protocol messages

Definition in file parsing.c.

Function Documentation

◆ parse_int32()

asciichat_error_t parse_int32 ( const char *  str,
int32_t *  out_value,
int32_t  min_value,
int32_t  max_value 
)

Parse signed 32-bit integer with range validation.

Parameters
strString to parse (must be null-terminated)
out_valueOutput: parsed integer value
min_valueMinimum allowed value (inclusive)
max_valueMaximum allowed value (inclusive)
Returns
ASCIICHAT_OK on success, ERROR_INVALID_PARAM on invalid input or out of range

Definition at line 240 of file parsing.c.

240 {
241 if (!str) {
242 return SET_ERRNO(ERROR_INVALID_PARAM, "String pointer is NULL");
243 }
244
245 if (!out_value) {
246 return SET_ERRNO(ERROR_INVALID_PARAM, "Output pointer is NULL");
247 }
248
249 long value;
250 asciichat_error_t err = parse_long(str, &value, (long)min_value, (long)max_value);
251 if (err != ASCIICHAT_OK) {
252 return err;
253 }
254
255 *out_value = (int32_t)value;
256 return ASCIICHAT_OK;
257}
SET_ERRNO
#define SET_ERRNO(code, context_msg,...)
Set error code with custom context message and log it.
Definition asciichat_errno.h:190
asciichat_error_t
asciichat_error_t
Error and exit codes - unified status values (0-255)
Definition error_codes.h:46
ASCIICHAT_OK
@ ASCIICHAT_OK
Definition error_codes.h:48
ERROR_INVALID_PARAM
@ ERROR_INVALID_PARAM
Definition error_codes.h:101
parse_long
asciichat_error_t parse_long(const char *str, long *out_value, long min_value, long max_value)
Parse signed long integer with range validation.
Definition parsing.c:96

References ASCIICHAT_OK, ERROR_INVALID_PARAM, parse_long(), and SET_ERRNO.

Referenced by strtoint_safe().

◆ parse_long()

asciichat_error_t parse_long ( const char *  str,
long *  out_value,
long  min_value,
long  max_value 
)

Parse signed long integer with range validation.

Parameters
strString to parse (must be null-terminated)
out_valueOutput: parsed integer value
min_valueMinimum allowed value (inclusive)
max_valueMaximum allowed value (inclusive)
Returns
ASCIICHAT_OK on success, ERROR_INVALID_PARAM on invalid input or out of range

Safe wrapper for strtol() with overflow detection and range validation.

Definition at line 96 of file parsing.c.

96 {
97 if (!str) {
98 return SET_ERRNO(ERROR_INVALID_PARAM, "String pointer is NULL");
99 }
100
101 if (!out_value) {
102 return SET_ERRNO(ERROR_INVALID_PARAM, "Output pointer is NULL");
103 }
104
105 if (*str == '\0') {
106 return SET_ERRNO(ERROR_INVALID_PARAM, "Empty string cannot be parsed as integer");
107 }
108
109 // Clear errno before calling strtol to detect errors
110 errno = 0;
111 char *endptr = NULL;
112 long value = strtol(str, &endptr, 10);
113
114 // Check for conversion errors
115 if (errno == ERANGE) {
116 return SET_ERRNO(ERROR_INVALID_PARAM, "Integer value out of range: %s", str);
117 }
118
119 // Check that entire string was consumed (no extra characters)
120 if (endptr == str || *endptr != '\0') {
121 return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid integer format: %s", str);
122 }
123
124 // Check user-specified range
125 if (value < min_value) {
126 return SET_ERRNO(ERROR_INVALID_PARAM, "Integer value %ld is below minimum %ld", value, min_value);
127 }
128
129 if (value > max_value) {
130 return SET_ERRNO(ERROR_INVALID_PARAM, "Integer value %ld exceeds maximum %ld", value, max_value);
131 }
132
133 *out_value = value;
134 return ASCIICHAT_OK;
135}
ERANGE
#define ERANGE
Definition windows_errno.h:65
errno
int errno

References ASCIICHAT_OK, ERANGE, errno, ERROR_INVALID_PARAM, and SET_ERRNO.

Referenced by parse_int32().

◆ parse_port()

asciichat_error_t parse_port ( const char *  str,
uint16_t *  out_port 
)

Parse port number (1-65535) from string.

Parameters
strString to parse (must be null-terminated)
out_portOutput: parsed port number
Returns
ASCIICHAT_OK on success, ERROR_INVALID_PARAM on invalid input or out of range

Convenience function for parsing TCP/UDP port numbers.

Definition at line 221 of file parsing.c.

221 {
222 if (!str) {
223 return SET_ERRNO(ERROR_INVALID_PARAM, "String pointer is NULL");
224 }
225
226 if (!out_port) {
227 return SET_ERRNO(ERROR_INVALID_PARAM, "Output pointer is NULL");
228 }
229
230 unsigned long port_ulong;
231 asciichat_error_t err = parse_ulong(str, &port_ulong, 1, 65535);
232 if (err != ASCIICHAT_OK) {
233 return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid port number: %s (must be 1-65535)", str);
234 }
235
236 *out_port = (uint16_t)port_ulong;
237 return ASCIICHAT_OK;
238}
uint16_t
unsigned short uint16_t
Definition common.h:57
parse_ulong
asciichat_error_t parse_ulong(const char *str, unsigned long *out_value, unsigned long min_value, unsigned long max_value)
Parse unsigned long integer with range validation.
Definition parsing.c:137

References ASCIICHAT_OK, ERROR_INVALID_PARAM, parse_ulong(), and SET_ERRNO.

Referenced by main(), parse_address_with_optional_port(), parse_ip_with_port(), validate_opt_port(), and validate_port_opt().

◆ parse_uint32()

asciichat_error_t parse_uint32 ( const char *  str,
uint32_t *  out_value,
uint32_t  min_value,
uint32_t  max_value 
)

Parse unsigned 32-bit integer with range validation.

Parameters
strString to parse (must be null-terminated)
out_valueOutput: parsed integer value
min_valueMinimum allowed value (inclusive)
max_valueMaximum allowed value (inclusive)
Returns
ASCIICHAT_OK on success, ERROR_INVALID_PARAM on invalid input or out of range

Definition at line 259 of file parsing.c.

259 {
260 if (!str) {
261 return SET_ERRNO(ERROR_INVALID_PARAM, "String pointer is NULL");
262 }
263
264 if (!out_value) {
265 return SET_ERRNO(ERROR_INVALID_PARAM, "Output pointer is NULL");
266 }
267
268 unsigned long value;
269 asciichat_error_t err = parse_ulong(str, &value, (unsigned long)min_value, (unsigned long)max_value);
270 if (err != ASCIICHAT_OK) {
271 return err;
272 }
273
274 *out_value = (uint32_t)value;
275 return ASCIICHAT_OK;
276}
uint32_t
unsigned int uint32_t
Definition common.h:58

References ASCIICHAT_OK, ERROR_INVALID_PARAM, parse_ulong(), and SET_ERRNO.

◆ parse_ulong()

asciichat_error_t parse_ulong ( const char *  str,
unsigned long *  out_value,
unsigned long  min_value,
unsigned long  max_value 
)

Parse unsigned long integer with range validation.

Parameters
strString to parse (must be null-terminated)
out_valueOutput: parsed integer value
min_valueMinimum allowed value (inclusive)
max_valueMaximum allowed value (inclusive)
Returns
ASCIICHAT_OK on success, ERROR_INVALID_PARAM on invalid input or out of range

Definition at line 137 of file parsing.c.

138 {
139 if (!str) {
140 return SET_ERRNO(ERROR_INVALID_PARAM, "String pointer is NULL");
141 }
142
143 if (!out_value) {
144 return SET_ERRNO(ERROR_INVALID_PARAM, "Output pointer is NULL");
145 }
146
147 if (*str == '\0') {
148 return SET_ERRNO(ERROR_INVALID_PARAM, "Empty string cannot be parsed as integer");
149 }
150
151 // Clear errno before calling strtoul to detect errors
152 errno = 0;
153 char *endptr = NULL;
154 unsigned long value = strtoul(str, &endptr, 10);
155
156 // Check for conversion errors
157 if (errno == ERANGE) {
158 return SET_ERRNO(ERROR_INVALID_PARAM, "Integer value out of range: %s", str);
159 }
160
161 // Check that entire string was consumed (no extra characters)
162 if (endptr == str || *endptr != '\0') {
163 return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid integer format: %s", str);
164 }
165
166 // Check user-specified range
167 if (value < min_value) {
168 return SET_ERRNO(ERROR_INVALID_PARAM, "Integer value %lu is below minimum %lu", value, min_value);
169 }
170
171 if (value > max_value) {
172 return SET_ERRNO(ERROR_INVALID_PARAM, "Integer value %lu exceeds maximum %lu", value, max_value);
173 }
174
175 *out_value = value;
176 return ASCIICHAT_OK;
177}

References ASCIICHAT_OK, ERANGE, errno, ERROR_INVALID_PARAM, and SET_ERRNO.

Referenced by main(), parse_port(), and parse_uint32().

◆ parse_ulonglong()

asciichat_error_t parse_ulonglong ( const char *  str,
unsigned long long *  out_value,
unsigned long long  min_value,
unsigned long long  max_value 
)

Parse unsigned long long integer with range validation.

Parameters
strString to parse (must be null-terminated)
out_valueOutput: parsed integer value
min_valueMinimum allowed value (inclusive)
max_valueMaximum allowed value (inclusive)
Returns
ASCIICHAT_OK on success, ERROR_INVALID_PARAM on invalid input or out of range

Definition at line 179 of file parsing.c.

180 {
181 if (!str) {
182 return SET_ERRNO(ERROR_INVALID_PARAM, "String pointer is NULL");
183 }
184
185 if (!out_value) {
186 return SET_ERRNO(ERROR_INVALID_PARAM, "Output pointer is NULL");
187 }
188
189 if (*str == '\0') {
190 return SET_ERRNO(ERROR_INVALID_PARAM, "Empty string cannot be parsed as integer");
191 }
192
193 // Clear errno before calling strtoull to detect errors
194 errno = 0;
195 char *endptr = NULL;
196 unsigned long long value = strtoull(str, &endptr, 10);
197
198 // Check for conversion errors
199 if (errno == ERANGE) {
200 return SET_ERRNO(ERROR_INVALID_PARAM, "Integer value out of range: %s", str);
201 }
202
203 // Check that entire string was consumed (no extra characters)
204 if (endptr == str || *endptr != '\0') {
205 return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid integer format: %s", str);
206 }
207
208 // Check user-specified range
209 if (value < min_value) {
210 return SET_ERRNO(ERROR_INVALID_PARAM, "Integer value too small (below minimum)");
211 }
212
213 if (value > max_value) {
214 return SET_ERRNO(ERROR_INVALID_PARAM, "Integer value too large (exceeds maximum)");
215 }
216
217 *out_value = value;
218 return ASCIICHAT_OK;
219}

References ASCIICHAT_OK, ERANGE, errno, ERROR_INVALID_PARAM, and SET_ERRNO.