Differences between revisions 3 and 4
Revision 3 as of 2007-12-12 14:17:39
Size: 7026
Comment:
Revision 4 as of 2007-12-14 15:43:31
Size: 7815
Comment: 1° revision, anclas y correcciones minimas.
Deletions are marked like this. Additions are marked like this.
Line 8: Line 8:
En determinadas ocasiones hace falta tener unos ciertos valores aleatorios, por ejemplo a la hora de programar juegos. En los juegos, muchas veces, hace falta elegir al azar qué carta se va a levantar, dónde se va a poner la mina, etc. Para tomar este tipo de decisiones hacen falta unos valores aleatorios, o sea, al azar o que se acerquen mucho a ello. Por esta necesidad es que se ha implementado en GLib la biblioteca gran.h, que consiste en una estructura de datos GRand y un conjunto de funciones. Estas funciones sirven para inicializar la estructura GRand, darle valores iniciales y obtener números aleatorios de distintos tipos. En determinadas ocasiones hace falta tener unos ciertos valores aleatorios, por ejemplo a la hora de programar juegos. En los juegos, muchas veces, hace falta elegir al azar qué carta se va a levantar, dónde se va a poner la mina, etc. Para tomar este tipo de decisiones hacen falta unos valores aleatorios, o sea, al azar o que se acerquen mucho a ello. Por esta necesidad es que se ha implementado en GLib la biblioteca gran.h, que consiste en una estructura de datos GRand y un conjunto de funciones. Estas funciones sirven para inicializar la estructura `GRand`, darle valores iniciales y obtener números aleatorios de distintos tipos.
Line 10: Line 10:
Lo de los tipos es en el sentido más informático de la palabra, porque todos son números aleatorios igualmente, con la diferencia de que en unos se obtiene un guint32, gdouble, gboolean (este último, evidentemente no es un número, es un booleano). Después algunas funciones establecen rangos para los números. Vamos, un número aleatorio entre el X y el Y. Lo de los tipos es en el sentido más informático de la palabra, porque todos son números aleatorios igualmente, con la diferencia de que en unos se obtiene un `guint32`, `gdouble`, `gboolean` (este último, evidentemente no es un número, es un booleano). Después algunas funciones establecen rangos para los números. Vamos, un número aleatorio entre el X y el Y.
Line 12: Line 12:
Cuando se habla de números pseudoaleatorios, hay que hablar irremediablemente de dos conceptos: PRNG(generador de números pseudo aleatorios) y "semilla". Cuando se habla de números pseudoaleatorios, hay que hablar irremediablemente de dos conceptos: `PRNG` (generador de números pseudo aleatorios) y "semilla".
Line 14: Line 14:
Un PRNG no es más que una estructura de datos con unos algoritmos asociados que, a partir de un valor inicial, genera secuencias de números en un orden, aparentemente aleatorio o, lo que es lo mismo, al azar y es aparentemente porque no es real; si se tuviera la tecnología y el tiempo suficiente, se podría encontrar un cierto orden lógico en las secuencias y predecirlas, pero eso es otro tema; a los efectos, serán considerados como realmente aleatorios. Un `PRNG` no es más que una estructura de datos con unos algoritmos asociados que, a partir de un valor inicial, genera secuencias de números en un orden, aparentemente aleatorio o, lo que es lo mismo, al azar y es aparentemente porque no es real; si se tuviera la tecnología y el tiempo suficiente, se podría encontrar un cierto orden lógico en las secuencias y predecirlas, pero eso es otro tema; a los efectos, serán considerados como realmente aleatorios.
Line 16: Line 16:
En el caso de GLIB, este PRNG, será GRand, que es una estructura que, aunque oculta a la visión del programador, es usada internamente por las funciones de la biblioteca grand.h. En el caso de GLib, este `PRNG`, será `GRand`, que es una estructura que, aunque oculta a la visión del programador, es usada internamente por las funciones de la biblioteca grand.h.
Line 18: Line 18:
El otro concepto es el de semilla. La semilla, no es más que ese valor inicial del que se hablaba antes. Un valor, a ser posible, bastante aleatorio en sí mismo. Para conseguir esta aleatoriedad, lo que se hace es pasarle este valor a la función correspondiente. En caso de que no se quiera pasar la semilla, el constructor de GRand, ''g_rand_new()'', se encargará de obtener un valor aleatorio de /dev/urandom, si existe, o la hora actual si no existiera. El otro concepto es el de semilla. La semilla, no es más que ese valor inicial del que se hablaba antes. Un valor, a ser posible, bastante aleatorio en sí mismo. Para conseguir esta aleatoriedad, lo que se hace es pasarle este valor a la función correspondiente. En caso de que no se quiera pasar la semilla, el constructor de `GRand`, ''[#g_rand_new g_rand_new()]'', se encargará de obtener un valor aleatorio de /dev/urandom, si existe, o la hora actual si no existiera.
Line 26: Line 26:
`void g_random_set_seed(guint32 semilla);` [[Anchor(g_random_set_seed)]]
{{{
void g_random_set_seed(guint32 semilla);
}}}
Line 30: Line 33:
`gboolean g_random_boolean();` [[Anchor(g_random_boolean)]]
{{{
gboolean g_random_boolean();
}}}
Line 34: Line 40:
`guint32 g_random_int(void);` [[Anchor(g_random_int)]]
{{{
guint32 g_random_int(void);
}}}
Line 38: Line 47:
`gint32 g_random_int_range(gint32 principio, gint32 end);` [[Anchor(g_random_int_range)]]
{{{
gint32 g_random_int_range(gint32 principio, gint32 end);
}}}
Line 42: Line 54:
`gdouble g_random_double(void);` [[Anchor(g_random_double)]]
{{{
gdouble g_random_double(void);
}}}
Line 46: Line 61:
`gdouble g_random_double_range(gdouble principio, gdouble fin);` [[Anchor(g_random_double_range)]]
{{{
gdouble g_random_double_range(gdouble principio, gdouble fin);
}}}
Line 50: Line 68:
En todos estos casos, internamente, se ha hecho uso de un tipo de dato: GRand. Si lo que necesitamos es obtener una serie de números aleatorios reproducibles, será una mejor opción trabajar directamente con este dato. En todos estos casos, internamente, se ha hecho uso de un tipo de dato: `GRand`. Si lo que necesitamos es obtener una serie de números aleatorios reproducibles, será una mejor opción trabajar directamente con este dato.
Line 52: Line 70:
La manera de hacerlo es crear primero un GRand y después trabajar con las funciones del tipo ''g_rand*''. La manera de hacerlo es crear primero un `GRand` y después trabajar con las funciones del tipo ''g_rand*''.
Line 54: Line 72:
`GRand *g_rand_new(void);` [[Anchor(g_rand_new)]]
{{{
GRand *g_rand_new(void);
}}}
Line 56: Line 77:
Crea un nuevo GRand. Los números aleatorios necesitan una semilla para inicializarse, pero en esta función no se le pasa ninguna, así que se tomaría como semilla un valor de /dev/urandom, si existe, o la hora actual. Crea un nuevo `GRand`. Los números aleatorios necesitan una semilla para inicializarse, pero en esta función no se le pasa ninguna, así que se tomaría como semilla un valor de /dev/urandom, si existe, o la hora actual.
Line 58: Line 79:
`GRand *g_rand_new_with_seed(guint32 semilla);` [[Anchor(g_rand_new_with_seed)]]
{{{
GRand *g_rand_new_with_seed(guint32 semilla);
}}}
Line 60: Line 84:
En este caso se crea un GRand usando una semilla. En este caso se crea un `GRand` usando una semilla.
Line 62: Line 86:
`void g_rand_set_seed(GRand *rand, guint32 semilla);` [[Anchor(g_rand_set_seed)]]
{{{
void g_rand_set_seed(GRand *rand, guint32 semilla);
}}}
Line 64: Line 91:
Con esta función se establece una nueva semilla a un GRand. Con esta función se establece una nueva semilla a un `GRand`.
Line 66: Line 93:
`void g_rand_free(GRand *rand);` [[Anchor(g_rand_free)]]
{{{
void g_rand_free(GRand *rand);
}}}
Line 70: Line 100:
`gboolean g_rand_boolean(GRand *rand);` [[Anchor(g_rand_boolean)]]
{{{
gboolean g_rand_boolean(GRand *rand);
}}}
Line 74: Line 107:
`guint32 g_rand_int(GRand *rand);` [[Anchor(g_rand_int)]]
{{{
guint32 g_rand_int(GRand *rand);
}}}
Line 78: Line 114:
`gint32 g_rand_int_range(GRand *rand, gint32 principio, gint32 fin);` [[Anchor(g_rand_int_range)]]
{{{
gint32 g_rand_int_range(GRand *rand, gint32 principio, gint32 fin);
}}}
Line 82: Line 121:
`gdouble g_rand_double(GRand *rand);` [[Anchor(g_rand_double)]]
{{{
gdouble g_rand_double(GRand *rand);
}}}
Line 86: Line 128:
`gdouble g_rand_double_range(GRand *rand, gint32 principio, gint32 fin);` [[Anchor(g_rand_double_range)]]
{{{
gdouble g_rand_double_range(GRand *rand, gint32 principio, gint32 fin);
}}}
Line 90: Line 135:
Con estas funciones se pueden obtener números o series de números pseudoaleatorios, de una manera rápida y fácil. Además con la ventaja añadida que ofrece GLIB de la portabilidad. Con estas funciones se pueden obtener números o series de números pseudoaleatorios, de una manera rápida y fácil. Además con la ventaja añadida que ofrece GLib de la portabilidad.
Line 96: Line 141:
`gchar* g_get_user_name (void);` [[Anchor(g_get_user_name)]]
{{{
gchar* g_get_user_name (void);
}}}
Line 98: Line 146:
`gchar* g_get_home_dir (void);` [[Anchor(g_get_home_dir)]]
{{{
gchar* g_get_home_dir (void);
}}}
Line 100: Line 151:
`gchar* g_get_tmp_dir(void);` [[Anchor(g_get_tmp_dir)]]
{{{
gchar* g_get_tmp_dir(void);
}}}
Line 102: Line 156:
`gchar* g_get_current_dir(void);` [[Anchor(g_get_current_dir)]]
{{{
gchar* g_get_current_dir(void);
}}}
Line 106: Line 163:
Estas funciones nos pueden resultar útiles, pero para aquellos que provengan del universo UNIX o GNU/Linux puede que no les sea suficiente. Esto es debido a que, en este tipo de sistemas operativos, el uso de variables de entorno en sus diferentes shells es muy extendido y en un momento dado, les interesaría recurrir a ellas. Para ello está la función ''g_getenv''. La cual es realmente agradable de usar ya que sólo necesitamos pasarle como parámetro la variable que necesitemos y esta función nos devolverá su valor en una cadena. Estas funciones nos pueden resultar útiles, pero para aquellos que provengan del universo UNIX o GNU/Linux puede que no les sea suficiente. Esto es debido a que, en este tipo de sistemas operativos, el uso de variables de entorno en sus diferentes shells es muy extendido y en un momento dado, les interesaría recurrir a ellas. Para ello está la función ''[#g_getenv g_getenv]''. La cual es realmente agradable de usar ya que sólo necesitamos pasarle como parámetro la variable que necesitemos y esta función nos devolverá su valor en una cadena.
Line 108: Line 165:
`gchar* g_getenv (const gchar * variable );` [[Anchor(g_getenv)]]
{{{
gchar* g_getenv (const gchar * variable );
}}}

Miscelánea de funciones

TableOfContents()

Números aleatorios.

En determinadas ocasiones hace falta tener unos ciertos valores aleatorios, por ejemplo a la hora de programar juegos. En los juegos, muchas veces, hace falta elegir al azar qué carta se va a levantar, dónde se va a poner la mina, etc. Para tomar este tipo de decisiones hacen falta unos valores aleatorios, o sea, al azar o que se acerquen mucho a ello. Por esta necesidad es que se ha implementado en GLib la biblioteca gran.h, que consiste en una estructura de datos GRand y un conjunto de funciones. Estas funciones sirven para inicializar la estructura GRand, darle valores iniciales y obtener números aleatorios de distintos tipos.

Lo de los tipos es en el sentido más informático de la palabra, porque todos son números aleatorios igualmente, con la diferencia de que en unos se obtiene un guint32, gdouble, gboolean (este último, evidentemente no es un número, es un booleano). Después algunas funciones establecen rangos para los números. Vamos, un número aleatorio entre el X y el Y.

Cuando se habla de números pseudoaleatorios, hay que hablar irremediablemente de dos conceptos: PRNG (generador de números pseudo aleatorios) y "semilla".

Un PRNG no es más que una estructura de datos con unos algoritmos asociados que, a partir de un valor inicial, genera secuencias de números en un orden, aparentemente aleatorio o, lo que es lo mismo, al azar y es aparentemente porque no es real; si se tuviera la tecnología y el tiempo suficiente, se podría encontrar un cierto orden lógico en las secuencias y predecirlas, pero eso es otro tema; a los efectos, serán considerados como realmente aleatorios.

En el caso de GLib, este PRNG, será GRand, que es una estructura que, aunque oculta a la visión del programador, es usada internamente por las funciones de la biblioteca grand.h.

El otro concepto es el de semilla. La semilla, no es más que ese valor inicial del que se hablaba antes. Un valor, a ser posible, bastante aleatorio en sí mismo. Para conseguir esta aleatoriedad, lo que se hace es pasarle este valor a la función correspondiente. En caso de que no se quiera pasar la semilla, el constructor de GRand, [#g_rand_new g_rand_new()], se encargará de obtener un valor aleatorio de /dev/urandom, si existe, o la hora actual si no existiera.

Para usar este generador de números pseudo aleatorios, es necesario incluir la biblioteca grand.h.

   1 #include <grand.h>
   2 

Para obtener números aleatorios rápidamente se pueden usar las siguientes funciones:

Anchor(g_random_set_seed)

void g_random_set_seed(guint32 semilla);

Con esta función se establece la semilla para la generación de aleatorios. Estableciendo esta semilla con un mismo número cada vez que se ejecute nuestro código, se obtendrá el mismo resultado para los números aleatorios que generemos. Si se desea que los aleatorios no coincidan nunca no estableceremos la semilla.

Anchor(g_random_boolean)

gboolean g_random_boolean();

Con esta función, se obtiene un booleano aleatorio.

Anchor(g_random_int)

guint32 g_random_int(void);

Se obtiene un gunt32 distribuido sobre el rango [0..2^32-1].

Anchor(g_random_int_range)

gint32 g_random_int_range(gint32 principio, gint32 end);

Se obtiene un gint32 distribuido sobre el rango [principio..fin-1].

Anchor(g_random_double)

gdouble g_random_double(void);

Se obtiene un gdouble distribuido sobre el rango [0..1).

Anchor(g_random_double_range)

gdouble g_random_double_range(gdouble principio, gdouble fin);

Se obtiene un gdouble distribuido sobre el rango[principio..fin).

En todos estos casos, internamente, se ha hecho uso de un tipo de dato: GRand. Si lo que necesitamos es obtener una serie de números aleatorios reproducibles, será una mejor opción trabajar directamente con este dato.

La manera de hacerlo es crear primero un GRand y después trabajar con las funciones del tipo g_rand*.

Anchor(g_rand_new)

GRand *g_rand_new(void);

Crea un nuevo GRand. Los números aleatorios necesitan una semilla para inicializarse, pero en esta función no se le pasa ninguna, así que se tomaría como semilla un valor de /dev/urandom, si existe, o la hora actual.

Anchor(g_rand_new_with_seed)

GRand *g_rand_new_with_seed(guint32 semilla);

En este caso se crea un GRand usando una semilla.

Anchor(g_rand_set_seed)

void g_rand_set_seed(GRand *rand, guint32 semilla);

Con esta función se establece una nueva semilla a un GRand.

Anchor(g_rand_free)

void g_rand_free(GRand *rand);

Libera la memoria usada por un GRand.

Anchor(g_rand_boolean)

gboolean g_rand_boolean(GRand *rand);

Devuelve el siguiente booleano aleatorio desde rand.

Anchor(g_rand_int)

guint32 g_rand_int(GRand *rand);

Devuelve el siguiente guint32 aleatorio desde rand entre los valores [0..2^32-1].

Anchor(g_rand_int_range)

gint32 g_rand_int_range(GRand *rand, gint32 principio, gint32 fin);

Devuelve el siguiente gint32 aleatorio desde rand entre los valores [principio..fin-1].

Anchor(g_rand_double)

gdouble g_rand_double(GRand *rand);

Devuelve el siguiente gdouble aleatorio desde rand entre los valores [0..1).

Anchor(g_rand_double_range)

gdouble g_rand_double_range(GRand *rand, gint32 principio, gint32 fin);

Devuelve el siguiente gdouble aleatorio desde rand entre los valores [principio..fin).

Con estas funciones se pueden obtener números o series de números pseudoaleatorios, de una manera rápida y fácil. Además con la ventaja añadida que ofrece GLib de la portabilidad.

Funciones de información sobre entorno.

Muchas veces, en los desarrollos de software, es necesario conocer e interactuar con información del entorno en el cual se esté trabajando. Por ejemplo, en un momento dado, podría ser necesario conocer información del usuario como su nombre, su directorio de trabajo o el directorio donde se pueda almacenar información temporal. Para todas estas acciones e incluso algunas más, se dispone de las siguientes funciones.

Anchor(g_get_user_name)

gchar* g_get_user_name (void);

Anchor(g_get_home_dir)

gchar* g_get_home_dir (void);

Anchor(g_get_tmp_dir)

gchar* g_get_tmp_dir(void);

Anchor(g_get_current_dir)

gchar* g_get_current_dir(void);

Después de haber visto la sintaxis de estas funciones no debe ser muy difícil imaginarse para qué sirve cada una, pero por si queda alguna duda, la primera devolverá el nombre del usuario que esté ejecutando el programa en ese momento; la segunda, su directorio de trabajo; la tercera, el directorio temporal habilitado en su sistema para ese fin y la última función nos devolverá el directorio en el que se esté trabajando actualmente.

Estas funciones nos pueden resultar útiles, pero para aquellos que provengan del universo UNIX o GNU/Linux puede que no les sea suficiente. Esto es debido a que, en este tipo de sistemas operativos, el uso de variables de entorno en sus diferentes shells es muy extendido y en un momento dado, les interesaría recurrir a ellas. Para ello está la función [#g_getenv g_getenv]. La cual es realmente agradable de usar ya que sólo necesitamos pasarle como parámetro la variable que necesitemos y esta función nos devolverá su valor en una cadena.

Anchor(g_getenv)

gchar* g_getenv (const gchar * variable );


Volver a: [:Documentacion/Desarrollo/Glib:GLib]

Documentacion/Desarrollo/Glib/MiscelaneaDeFunciones (last edited 2008-12-04 08:48:56 by localhost)