EasyConnect

EasyConnect is a simple networking library that probably isn't good enough to use in every situation but good enough to be usable.
EasyConnect uses a multithreaded callback system to interface with the user logic.

How to use

Initialization

Regardless of wether you want to setup a server or client you'll have to call InitEC() to initialize EasyConnect.
Once successfully done you can setup your networking element.

#include <ec.h>
#include <stdio.h>

int main(int argc, char **argv)
{
	unsigned int err = 0;
	if((err = InitEC(argc, argv)))
	{
		printf("%s(Code: %d)\n", ECErrorCodeToString(err), err);
		return err;
	}

	// ...
}

Network setup

After initializing EasyConnect you can set your callbacks or immediately setup the networking element you wish.

#include <ec.h>
#include <stdio.h>

void error(unsigned int errorCode)
{
	printf("%s(Code: %d)\n", ECErrorCodeToString(err), err);
}

void DataReceived(ECClient *client, char *ip, int port, int nsize, void *data)
{
	printf("%s(Port: %d):'%s'\n", ip, port, (char*)data);
}

int main(int argc, char **argv)
{
	unsigned int err = 0;
	if((err = InitEC(argc, argv)))
	{
		printf("%s(Code: %d)\n", ECErrorCodeToString(err), err);
		return err;
	}

	ECServer server = { 0 };
	ECClient client = { 0 };

	ECServer_OnDataReceive(DataReceive);

	if((err = ECServer_Start(&server, TCP, 16380, 5)))
	{
		error(err);
		return err;
	}
	if((err = ECClient_Connect(&client, TCP, "127.0.0.1", 16380)))
	{
		error(err);
		return err;
	}

	// Or set callback here, just set before you 
	// send/receive any data as otherwise the packages may be lost
	if((err = ECClient_Send(&client, 6, "Hello"))) // 6 because of the '\0'
	{
		error(err);
		return err;
	}

	// Other stuff, calling ECClient_Disconnect(&client) and ECServer_Shutdown(&server), etc..

	return 0;
}

Error handling

EasyConnect returns an error code for every provided function, save ECErrorCodeToString().
To convert an error code to a string call [the previously mentioned] ECErrorCodeToString() function, passing in the error code.

Error coverage(inside of the library functions) contains:

• EasyConnect being uninitialized
• Null references
• Invalid arguments
• Invalid operations
• [unspecified] Networking errors (in improvement)
• Index out of range

Should ECErrorCodeToString() be given an invalid error code, an "Index out of range" error will be returned. This is the only instance in the library interface where it can occur.

Callbacks

Server

The EasyConnect server uses three callbacks: OnDataReceive, OnConnectionCreate and OnConnectionTerminated.

OnDataReceive

Definition:

typedef void(*ECSERVERDATARECEIVEPROC)(ECClient *client, char *ip, int port, int nsize, void *data);

To set this callback you need to call ECServer_OnDataReceive():

ECSERVERDATARECEIVEPROC oldHandler = ECServer_OnDataReceive(newHandler);

OnConnectionCreated

Definition:

typedef void(*ECSERVERCONNECTIONCREATEPROC)(char *ip, int port);

To set this callback you need to call ECServer_OnConnectionCreate():

ECSERVERCONNECTIONCREATEPROC oldHandler = ECServer_OnConnectionCreate(newHandler);

OnConnectionTerminated

Definition:

typedef void(*ECSERVERCONNECTIONTERMINATEDPROC)(char *ip, int port);

To set this callback you need to call ECServer_OnConnectionTerminated():

ECSERVERCONNECTIONTERMINATEDPROC oldHandler = ECServer_OnConnectionTerminated(newHandler);

Client

The EasyConnect client uses two callbacks: OnDataReceive and OnConnectionTerminated(from the server side).

OnDataReceive

Definition:

typedef void(*ECCLIENTDATARECEIVEPROC)(int nsize, void *data);

To set this callback you need to call ECServer_OnDataReceive():

ECCLIENTDATARECEIVEPROC oldHandler = ECClient_OnDataReceive(newHandler);

OnConnectionTerminated

Definition:

typedef void(*ECCLIENTCONNECTIONTERMINATEDPROC)(void);

To set this callback you need to call ECServer_OnConnectionTerminated():

ECCLIENTCONNECTIONTERMINATEDPROC oldHandler = ECClient_OnConnectionTerminated(newHandler);