Classe C++ : Socket¶
Description¶
Propriétaire non copiable d’une socket IPv4 TCP/UDP.
Nom complet : gaspardos::Socket.
En-tête : bindings/cpp/gaspardos.hpp. C++98.
Dans quel cas l’utiliser¶
Échanger des données réseau avec les erreurs natives visibles.
Exemple de programme simple¶
#include "gaspardos.hpp"
#include <cstdio>
#include <cstring>
int main()
{
gaspardos::Socket socket;
if (socket.open(GO64_DGRAM) < 0)
return 1;
GO64_SocketAddress address = gaspardos::ipv4(127, 0, 0, 1, 19002);
const char message[] = "hello";
int64_t sent = socket.sendTo(message, sizeof(message) - 1, &address);
int64_t closed = socket.close();
return sent == static_cast<int64_t>(sizeof(message) - 1) && closed == 0 ? 0 : 1;
}
Compilation depuis Windows¶
Enregistrer le programme ci-dessus dans build/api-examples/Socket.cpp, depuis la racine du dépôt. Créer le dossier si nécessaire.
PowerShell — depuis la racine du dépôt :
New-Item -ItemType Directory -Force build/api-examples | Out-Null
& .\build-x64-install\bin\x86_64-gaspardos-gcc.exe -std=gnu1x -O2 -mno-red-zone -c bindings/native/gaspardos_x64_syscall.c -o build/api-examples/syscall.o
if ($LASTEXITCODE -ne 0) { throw "C compilation failed" }
& .\build-x64-install\bin\x86_64-gaspardos-g++.exe -std=c++98 -O2 -Ibindings/cpp build/api-examples/Socket.cpp build/api-examples/syscall.o -o build/api-examples/Socket-x64.elf
if ($LASTEXITCODE -ne 0) { throw "C++ compilation/link failed" }
Le binaire ELF s’exécute sous GaspardOS, pas sous Windows. Le pilote fournit CRT et bibliothèques. Préparer les volumes/services requis ; les exemples bornent leurs attentes et peuvent sortir sur saturation au lieu de réessayer. Une compilation réussie ne valide pas l’exécution noyau.
Les fichiers nécessaires à cet exemple sont disponibles dans la section Source files (en anglais).
Méthodes de la classe¶
Socket()¶
Handle initial -1.
~Socket()¶
Tente close une fois.
int64_t handle() const¶
Handle brut ou -1.
int64_t close()¶
Conserve la propriété en cas d’échec.
int64_t open(uint64_t type = GO64_STREAM, uint64_t protocol = 0)¶
AF_INET, STREAM par défaut, protocole 0 ; handle ou erreur.
int64_t bind(const GO64_SocketAddress& a)¶
Associe une adresse de 8 octets ; port en ordre réseau.
int64_t listen(int64_t backlog)¶
Écoute avec la file backlog.
int64_t accept(Socket& peer, GO64_SocketAddress* address = 0)¶
Transfère le nouveau handle à peer ; -16 si peer ouvert ; adresse optionnelle.
int64_t connect(const GO64_SocketAddress& a)¶
Connexion à une IPv4 sans résolution DNS.
int64_t send(const void* p, uint64_t n)¶
Octets envoyés ou erreur ; les transferts partiels sont visibles.
int64_t receive(void* p, uint64_t n)¶
Octets reçus ou erreur ; 0 sur fin de flux selon le noyau.
int64_t sendTo(const void* p, uint64_t n, const GO64_SocketAddress* a)¶
Datagramme vers une adresse optionnelle ; flags 0.
int64_t receiveFrom(void* p, uint64_t n, GO64_SocketAddress* a = 0)¶
Reçoit et renseigne éventuellement la source ; longueur réinitialisée à chaque appel.
int64_t localAddress(GO64_SocketAddress& a)¶
Adresse locale ; longueur remise à sizeof(a).
int64_t peerAddress(GO64_SocketAddress& a)¶
Adresse distante ; longueur remise à sizeof(a).
Contrat natif¶
ABI LP64, wchar_t 32 bits, aucun packing. Les résultats négatifs natifs ne sont pas errno. Traiter -11 avec yield et une limite applicative. Les objets référencés doivent survivre à leurs utilisateurs ; ne pas copier les propriétaires de handles. File utilise stdio/errno et invalide son flux sur close, même sur erreur.