comun.hpp

/** @file comun.hpp
 * Datos comunes.
 *
 * @package Mt77
 * @author Vladimir Támara Patiño. vtamara@pasosdeJesus.org
 * Dominio público. 2008. Sin garantías
 * http://creativecommons.org/licenses/publicdomain/
 * @version   $Id: comun.hpp,v 1.11 2010/01/18 16:12:50 vtamara Exp $
 */


#if !defined(Comun_hpp)
#define Comun_hpp

#include <set>
#include <string>
#include <ostream>
#include <sstream>
#include <iomanip>
#include <stdint.h>

#ifdef ASSERT
#undef ASSERT
#endif
#ifdef NDEBUG
#define ASSERT(x) ((void)0)
#warning NDEBUG activo compilando sin ASSERT
#else
#define ASSERT(x) \
  if (! (x)) \
  { \
    stringstream _sa; _sa.clear(); _sa.str(""); \
    _sa << __FILE__ << ":" << __LINE__ << "Falló aserción " << #x << " \n"; \
    throw std::string(_sa.str()); \
  }
#endif

/** Máxima longitud de un URL --de documentaos indexables */
const uint32_t MAXLURL = 1024;

/** Máxima longitud de un condensado */
const uint32_t MAXLCONDENSADO = 64;

/** Máxima longitud de un hexadecimal.  Usado por lo menos en
 *  indice de documento en posición, posiciones dentro del índice. */
const uint32_t MAXLHEX = 8;

/** Máxima longitud de un 128b (número en base 128).  Por usar en
 * índice de documento, posición, ``apuntadores'' al archivo
 */
const int MAXL128B = 5;

/**
 * Máxima longitud de un número en formato escogido para archivo
 **/
const int MAXLNUMERO = MAXL128B;

/** Máxima longitud de un decimal. Empleado por lo menos para
 * indexar documentos referenciados por un índice. */
const int MAXLDEC = 10;

/** Tamaño máximo de una cadena indexable */
const uint32_t MAXCAD = 32;

using namespace std;

/** Marca en índice */
const string MARCAIND = "Mt77:\xedndiceP6";


/** Marca en relación de documentos */
const string MARCAREL = "Mt77:relaci\xf3nP6";


/** Caracter que marca final de una cadena en archivo */
const char FINCADENA = '{';

/**
 * Verifica nombre de índice, y genera nombre de relación de documentos
 * asociada
 * @param na Nombre de índice
 * @param nrel con espacio para MAXLURL caracteres, retorna nombre de rel.
 */
void verificaNombre(const char *na, char *nrel) throw(string);


/**
 * Formatea un conjunto a un flujo de salida
 * @param os Flujo de sálida
 * @param c Conjunto
 * @return El mismo flujo de sálida recibido pero tras envíar una represntación
 * plan del conjunto
 */
template <class T>
std::ostream &
operator<<(std::ostream &os, set<T> c)
{
        os <<"{";
        typename set<T>::iterator i;
        string sep = "";
        for (i = c.begin(); i != c.end(); i++) {
                os << sep << *i;
                sep = ", ";
        }
        os <<"}";
        return os;
}

/**
 * Retorna el prefijo común más largo de dos cadenas
 * @param a Primera cadena
 * @param b Segunda cadena
 **/
string prefijo_comun_mas_largo(string a, string b);

/**
 * Retorna cadena de error con posición de is
 * @param is Flujo de entrada
 * @param m Cadena con error
 * @return Cadena con mensaje de error precedido de posición en is
 **/
std::string errorFormato(std::istream &is, string m);

/**
 * Lee una cadena
 * @param is flujo de entrada
 **/
string leeCad(istream &is) throw(string);

/**
 * Lee un número hexadecimal
 * @param is flujo de entrada
 **/
long leeHex(std::istream &is) throw(string);


/**
 * Escribe en os un entero como hexadecimal de 8 digitos.
 * @param os Flujo de salida
 * @param n Número por escribir como hexadecimla de 8 dígitos
 **/
void escribeHex(std::ostream &os, uint32_t n);

/**
 * Lee un número en base 128.
 * Cada digito es un caracter entre '0' (ASCII 48) y el de ASCII 175.
 * Con 5 dígitos de estos puede representarse más de 4294967295 = 0xFFFFFFFF
 * @param is flujo de entrada
 **/
long lee128b(std::istream &is) throw(string);


/**
 * Escribe en os un entero en base 128.
 * @see lee128b
 * @param os Flujo de salida
 * @param n Número por escribir en base 128
 **/
void escribe128b(std::ostream &os, uint32_t n);

/**
 * Convierte número a cadena en base 128b
 * @see lee128b
 * @param n Número por retornar
 */
string n128b_c(uint32_t n);

/**
 * Convierte número en base 128 a entero
 * @see lee128b
 * @param s Cadena con númro en base 128
 */
uint32_t c_n128b(string s);

/**
 * Retorna longitud de un número en base 128
 * @param n número
 *
 * @return longitud
 */
inline uint32_t
long128b(uint32_t n)
{
        return MAXL128B;
}


/**
 * Lee un número en formato escogido para desplazamientos
 * @param is flujo de entrada
 **/
inline uint32_t
leeNDesp(std::istream &is) throw (std::string)
{
        return lee128b(is);
}


/**
 * Escribe un número en el formato escogido para desplazamientos
 * @param os Flujo de salida
 * @param n Número por escribir
 **/
inline void
escribeNDesp(std::ostream &os, uint32_t n)
{
        escribe128b(os, n);
}


/**
 * Retorna longitud del número n al escribirlo con escribeNDesp
 */
inline uint32_t
longNDesp(uint32_t n)
{
        return MAXL128B;
}


/**
 * Normaliza primer caracter de cadena en UTF-8
 * @param c Cadena cuyo primer caracter se normaliza
 * @param inc Cantidad de bytes de primer caracter normalizado
 * @return Cadena que corresponde a primer caracter de c normalizado
 *   (tipicamente mayúscula o vacío)
 */
string normalizaCaracter(string c, int &inc);

/**
 * Normaliza cadena 
 * @param s Cadena por normalizar
 * @param latin1 Indica si c está en codificación LATIN1 dlc es UTF-8
 * @return Cadena normalizada y convertida a UTF-8 si hacía falta
 **/
string normaliza(string s, bool latin1 = false);

/**
 * Convierte primer caracter de cadena u8 con codificación UTF-8 al
 * caracter que le corresponde en codificación latin1.
 * Inspirado en
 * - utf8_decode de
 * http://svn.apache.org/repos/asf/stdcxx/branches/4.1.3/util/charmap.cpp
 * - latin1_toUtf8 de expat
 *
 * @param u8 Cadena en UTF-8
 * @param latin1 Caracter de salida
 * @return Cantidad de bytes leidos de u8 para la conversión
 */
int car_utf8_a_latin1(const char *u8, char *latin1);

/**
 * Convierte cadena u8 con codificación UTF-8 a latin 1 (ISO8859-1).
 *
 * @param u8 Cadena en UTF-8
 * @param len Longitud de u8
 * @return Cadena convertida
 *
 */
string utf8_a_latin1(const char *u8, int len);

/**
 * Divide una cadena de acuerdo a un delimitador
 * @param delimitador subcadena que marca donde dividir
 * @param cad Cadena por dividir
 *
 * @return Vector de subcadenas
 */
vector<string> estalla(const string &delimitador, const string &cad);


/**
 * Crea un directorio temporal y retorna su nombre.
 * Basado en pagina man de mktemp.
 * @return Ruta del directorio temporal
 */
string directorio_temp();


string cadena_latin1_a_utf8(string str);

#endif