X-Git-Url: https://git.teslayout.com/public/public/public/?a=blobdiff_plain;f=include%2Fanna%2Fcomm%2Ffunctions.hpp;h=8ec1cc4afa6ec1656c8b9e21ed892dc4c3b8cb51;hb=3e258840b15577cb8bda3cdedd0b9b88e16404b3;hp=315897a41927ac325390f0c82f16060cc8083909;hpb=4e12ac57e93c052f716a6305ad8fc099c45899d1;p=anna.git diff --git a/include/anna/comm/functions.hpp b/include/anna/comm/functions.hpp index 315897a..8ec1cc4 100644 --- a/include/anna/comm/functions.hpp +++ b/include/anna/comm/functions.hpp @@ -1,4 +1,4 @@ -// ANNA - Anna is Not 'N' Anymore +// ANNA - Anna is Not Nothingness Anymore // // (c) Copyright 2005-2014 Eduardo Ramos Testillano & Francisco Ruiz Rayo // @@ -37,8 +37,6 @@ #ifndef anna_comm_functions_hpp #define anna_comm_functions_hpp -#include - #include #include @@ -52,116 +50,33 @@ class Server; class Service; /** - functions - Metodos y variables + functions - Methods and variables */ struct functions : public anna::app::functions { /** - Devuelve el nombre de la maquina sobre la que estamos ejecutando. - \return El nombre de la maquina sobre la que estamos ejecutando. + Returns the host name over which we are executing our process. + @return host name over which we are executing our process. */ static std::string getHostName() throw(RuntimeException); /** - * Helper de uso externo que resuelve el nombre de la maquina recibido como parametro y devuelve - * la primera IP resuelta por el sistema. Tracea los aliases y sus direcciones IP, asi como el - * nombre oficial de la maquina. - * - * \param hostname Nombre logico del servidor que sera usado para resolver. Podria ser una cadena - * de la forma www.gopher.net - * - * \return Primera direccion IP retornadas por el sistema - * - * \see man gethostbyname. - */ - static std::string resolveIP(const char* hostname) throw(RuntimeException); // EDU Nov 2012 - - /** - Devuelve la referencia de la instancia de nuestra aplicación para trabajar en la - capa anna.comm - @return La referencia de la instancia de nuestra aplicación para trabajar en la - capa anna.comm - */ - static comm::Application& getApp() throw(RuntimeException); + Resolves the host name provided with the first IP returned by the system. + Aliases and their addresses are traced as well as the official host name. - /** - Codifica un entero de 32 bits en buffer que debe tener, al menos, 4 bytes de longitud. - @param result Buffer donde vamos a codificar el número. - @param n Nmero a codificar. - \return El buffer que contiene el número aplanado. - */ - static const char* codeInteger(char* result, const int n) throw(); + @param hostname Logical name for the server used to resolve (could be www.gopher.net i.e.). - /** - Codifica un entero de 16 bits en buffer que debe tener 2 bytes de longitud. - @param result Buffer donde vamos a codificar el número. - @param n Nmero a codificar. - \return El buffer que contiene el número aplanado. - */ - static const char* codeShort(char* result, const short int n) throw(); - - /** - Codifica un entero de 64 bits en buffer que debe tener, al menos, 8 bytes de longitud. - @param result Buffer donde vamos a codificar el numero. - @param n numero a codificar. - \return El buffer que contiene el numero aplanado. - */ - static const char* codeInteger64(char* result, const Integer64 n) throw(); - - /** - * Codifica un número en coma flotante de 32 bits según el estandard IEEE-754, en un buffer - * que debe tener, al menos, 4 bytes de longitud. - * @param result Buffer donde vamos a codificar el número. - * @param n Nmero a codificar. - * \return El buffer que contiene el número aplanado. - */ - static const char* codeFloat(char* result, const float n) throw(); + @return First IP address returned by the system. - /** - * Codifica un número en coma flotante de 64 bits según el estandard IEEE-754, en un buffer - * que debe tener, al menos, 8 bytes de longitud. - * @param result Buffer donde vamos a codificar el número. - * @param n Nmero a codificar. - * \return El buffer que contiene el número aplanado. + \see man gethostbyname. */ - static const char* codeDouble(char* result, const double n) throw(); - - /** - Decodifica un numero entero de 32 bits contenido en un buffer de 4 bytes. - @param data Buffer que contiene el numero aplanado. - @return El valor del numero contenido en el buffer. - */ - static int decodeInteger(const char* data) throw(); - - /** - Decodifica un numero entero de 16 bits contenido en un buffer de 2 bytes. - @param data Buffer que contiene el numero aplanado. - @return El valor del numero contenido en el buffer. - */ - static short int decodeShort(const char* data) throw(); + static std::string resolveIP(const char* hostname) throw(RuntimeException); /** - Decodifica un numero entero de 64 bits contenido en un buffer de 8 bytes. - @param data Buffer que contiene el numero aplanado. - @return El valor del numero contenido en el buffer. + Returns our application instance on anna.comm layer. + @return Reference to our application instance on anna.comm layer. */ - static Integer64 decodeInteger64(const char* data) throw(); - - /** - Decodifica un numero en coma flotante de 32 bits contenido en un buffer de 4 bytes, y codificado - según el estandard IEEE-754. - @param data Buffer que contiene el numero aplanado. - @return El valor del numero contenido en el buffer. - */ - static float decodeFloat(const char* data) throw(); - - /** - Decodifica un numero en coma flotante de 64 bits contenido en un buffer de 8 bytes, y codificado - según el estandard IEEE-754. - @param data Buffer que contiene el numero aplanado. - @return El valor del numero contenido en el buffer. - */ - static double decodeDouble(const char* data) throw(); + static comm::Application& getApp() throw(RuntimeException); }; }