Diferencias entre las revisiones 2 y 4 (abarca 2 versiones)
Versión 2 con fecha 2007-12-11 14:48:00
Tamaño: 7051
Comentario:
Versión 4 con fecha 2007-12-14 15:43:31
Tamaño: 7815
Comentario: 1° revision, anclas y correcciones minimas.
Los textos eliminados se marcan así. Los textos añadidos se marcan así.
Línea 5: Línea 5:
== Miscelánea de funciones. == == ==
Línea 8: Línea 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.
Línea 10: Línea 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.
Línea 12: Línea 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".
Línea 14: Línea 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.
Línea 16: Línea 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.
Línea 18: Línea 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.
Línea 26: Línea 26:
`void g_random_set_seed(guint32 semilla);` [[Anchor(g_random_set_seed)]]
{{{
void g_random_set_seed(guint32 semilla);
}}}
Línea 30: Línea 33:
`gboolean g_random_boolean();` [[Anchor(g_random_boolean)]]
{{{
gboolean g_random_boolean();
}}}
Línea 34: Línea 40:
`guint32 g_random_int(void);` [[Anchor(g_random_int)]]
{{{
guint32 g_random_int(void);
}}}
Línea 38: Línea 47:
`gint32 g_random_int_range(gint32 principio, gint32 end);` [[Anchor(g_random_int_range)]]
{{{
gint32 g_random_int_range(gint32 principio, gint32 end);
}}}
Línea 42: Línea 54:
`gdouble g_random_double(void);` [[Anchor(g_random_double)]]
{{{
gdouble g_random_double(void);
}}}
Línea 46: Línea 61:
`gdouble g_random_double_range(gdouble principio, gdouble fin);` [[Anchor(g_random_double_range)]]
{{{
gdouble g_random_double_range(gdouble principio, gdouble fin);
}}}
Línea 50: Línea 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.
Línea 52: Línea 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*''.
Línea 54: Línea 72:
`GRand *g_rand_new(void);` [[Anchor(g_rand_new)]]
{{{
GRand *g_rand_new(void);
}}}
Línea 56: Línea 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.
Línea 58: Línea 79:
`GRand *g_rand_new_with_seed(guint32 semilla);` [[Anchor(g_rand_new_with_seed)]]
{{{
GRand *g_rand_new_with_seed(guint32 semilla);
}}}
Línea 60: Línea 84:
En este caso se crea un GRand usando una semilla. En este caso se crea un `GRand` usando una semilla.
Línea 62: Línea 86:
`void g_rand_set_seed(GRand *rand, guint32 semilla);` [[Anchor(g_rand_set_seed)]]
{{{
void g_rand_set_seed(GRand *rand, guint32 semilla);
}}}
Línea 64: Línea 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`.
Línea 66: Línea 93:
`void g_rand_free(GRand *rand);` [[Anchor(g_rand_free)]]
{{{
void g_rand_free(GRand *rand);
}}}
Línea 70: Línea 100:
`gboolean g_rand_boolean(GRand *rand);` [[Anchor(g_rand_boolean)]]
{{{
gboolean g_rand_boolean(GRand *rand);
}}}
Línea 74: Línea 107:
`guint32 g_rand_int(GRand *rand);` [[Anchor(g_rand_int)]]
{{{
guint32 g_rand_int(GRand *rand);
}}}
Línea 78: Línea 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);
}}}
Línea 82: Línea 121:
`gdouble g_rand_double(GRand *rand);` [[Anchor(g_rand_double)]]
{{{
gdouble g_rand_double(GRand *rand);
}}}
Línea 86: Línea 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);
}}}
Línea 90: Línea 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.
Línea 96: Línea 141:
`gchar* g_get_user_name (void);` [[Anchor(g_get_user_name)]]
{{{
gchar* g_get_user_name (void);
}}}
Línea 98: Línea 146:
`gchar* g_get_home_dir (void);` [[Anchor(g_get_home_dir)]]
{{{
gchar* g_get_home_dir (void);
}}}
Línea 100: Línea 151:
`gchar* g_get_tmp_dir(void);` [[Anchor(g_get_tmp_dir)]]
{{{
gchar* g_get_tmp_dir(void);
}}}
Línea 102: Línea 156:
`gchar* g_get_current_dir(void);` [[Anchor(g_get_current_dir)]]
{{{
gchar* g_get_current_dir(void);
}}}
Línea 106: Línea 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.
Línea 108: Línea 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 (última edición 2008-12-04 08:48:56 efectuada por anónimo)