TcpServer/TcpReactor Framework

2026-09-08 10:35:16 +08:00
parent 4711ab6603
commit ac4045a979
23 changed files with 1831 additions and 20 deletions
@@ -0,0 +1,64 @@
+#ifndef INCLUDED_C_SOCKADDR_H
+#define INCLUDED_C_SOCKADDR_H
+
+#ifndef INCLUDED_C_SOCKET_H
+#include <c_Socket.h>
+#endif /*INCLUDED_C_SOCKET_H*/
+
+
+/* ------------------------------------------------------------------------------------------------------------------ */
+/*  */
+
+typedef struct {
+    union {
+        struct sockaddr_in  ipv4;
+        struct sockaddr_in6 ipv6;
+        struct sockaddr_storage storage;
+    };
+    c_size_t size;
+}c_SockAddr_t;
+
+/* ------------------------------------------------------------------------------------------------------------------ */
+/*  */
+
+
+c_err_t c_SockAddr_Init(c_SockAddr_t* self, int family, const char* ip, uint16_t port) ;
+
+/**
+ * @brief Gets the address family (AF_INET or AF_INET6) from the sockaddr variant.
+ * @return The address family integer, or -1 on parameter error.
+ */
+C_STATIC_FORCE_INLINE
+int c_SockAddr_GetFamily(const c_SockAddr_t* self) {
+    if (!self) return -1;
+    /* Since both structure variations map the sa_family / sin_family field
+       at byte offset 0, reading from ipv4 is universally safe across families */
+    return (int)self->ipv4.sin_family;
+}
+
+/**
+ * @brief Safely returns the port number (in host byte order) from the sockaddr variant.
+ * @return The port integer (0 to 65535), or 0 on error.
+ */
+C_STATIC_FORCE_INLINE
+uint16_t c_SockAddr_GetPort(const c_SockAddr_t* self) {
+    if (!self) return 0;
+    if (self->ipv4.sin_family == AF_INET) {
+        return ntohs(self->ipv4.sin_port);
+    } else if (self->ipv4.sin_family == AF_INET6) {
+        return ntohs(self->ipv6.sin6_port);
+    }
+    return 0;
+}
+
+
+/**
+ * @brief Converts the embedded binary IP address to a safe human-readable text string.
+ * @param out_str Pre-allocated destination character string buffer.
+ * @param str_cap Capacity ceiling limit of out_str (Recommended min size: INET6_ADDRSTRLEN).
+ */
+c_err_t c_SockAddr_ToString(const c_SockAddr_t* self, char* out_str, c_size_t str_cap);
+
+
+
+#endif /*INCLUDED_C_SOCKADDR_H*/