Referencia del Namespace ADH

ADH son las siglas de adolfo@di-mare.com. Más...

Clases
class	rational
	La clase rational implementa las operaciones aritméticas principales para números rationales. Más...
Funciones
	USING_namespace (ADH)
long	mcd (long x, long y)
	Calcula el Máximo Común Divisor de los números "x" y "y".
long	gcd (long x, long y)
	Sinónimo de mcd(x,y) [ inline ] .
rational &	operator*= (rational &a, const rational &b)
	Multiplica "*a" por "b".
bool	operator== (const rational &x, const rational &y)
	¿ x == y ?
bool	operator< (const rational &x, const rational &y)
	¿ x < y ?
bool	operator> (const rational &x, const rational &y)
	¿ x > y ?
bool	operator!= (const rational &x, const rational &y)
	¿ x != y ?
bool	operator<= (const rational &x, const rational &y)
	¿ x <= y ?
bool	operator>= (const rational &x, const rational &y)
	¿ x >= y ?
double	real (const rational &num)
	Convertidor a punto flotante.
long	integer (const rational &num)
	Convertidor a punto fijo.
bool	check_ok_externo (const rational &r)
bool	check_ok (const rational &r)
	Verifica la invariante de la clase rational.
bool	check_ok_no_Rep (const rational &r)
	Verifica la invariante de la clase rational.
std::ostream &	operator<< (std::ostream &COUT, const rational &r)
	Graba el valor de "r" en el flujo "COUT".
std::istream &	operator>> (std::istream &CIN, rational &r)
	Lee del flujo de texto "CIN" el valor de "r".
rational	operator+ (const rational &x, const rational &y)
	"x+y".
rational	operator- (const rational &x, const rational &y)
	"x-y".
rational	operator* (const rational &x, const rational &y)
	"x*y".
rational	operator/ (const rational &x, const rational &y)
	"x/y".

---

Descripción detallada

ADH son las siglas de adolfo@di-mare.com.

---

Documentación de las funciones

ADH::USING_namespace

(

ADH

)

long ADH::mcd	(	long	x,
		long	y
	)

Calcula el Máximo Común Divisor de los números "x" y "y".

• mcd(x,y) >= 1 siempre.
• MCD <==> GCD: Greatest Common Divisor .

Precondición:

(y != 0)

Comentarios:

Se usa el algoritmo de Euclides para hacer el cálculo.

Ejemplo:

    2*3*5 == mcd( 2*2*2*2 * 3*3 * 5*5, 2*3*5 )
       30 == mcd( -3600, -30 )

Definición en la línea 112 del archivo rational.cpp.

long ADH::gcd	(	long	x,
		long	y
	)			[inline]

Sinónimo de mcd(x,y) [ inline ] .

Definición en la línea 97 del archivo rational.h.

rational & ADH::operator*=	(	rational &	a,
		const rational &	b
	)

Multiplica "*a" por "b".

Definición en la línea 177 del archivo rational.cpp.

bool ADH::operator==	(	const rational &	x,
		const rational &	y
	)			[inline]

¿ x == y ?

Definición en la línea 185 del archivo rational.h.

bool ADH::operator<	(	const rational &	x,
		const rational &	y
	)			[inline]

¿ x < y ?

Definición en la línea 196 del archivo rational.h.

bool ADH::operator>	(	const rational &	x,
		const rational &	y
	)			[inline]

¿ x > y ?

Definición en la línea 217 del archivo rational.h.

bool ADH::operator!=	(	const rational &	x,
		const rational &	y
	)			[inline]

¿ x != y ?

Definición en la línea 222 del archivo rational.h.

bool ADH::operator<=	(	const rational &	x,
		const rational &	y
	)			[inline]

¿ x <= y ?

Definición en la línea 227 del archivo rational.h.

bool ADH::operator>=	(	const rational &	x,
		const rational &	y
	)			[inline]

¿ x >= y ?

Definición en la línea 232 del archivo rational.h.

double ADH::real

(

const rational &

num

)

[inline]

Convertidor a punto flotante.

Definición en la línea 237 del archivo rational.h.

long ADH::integer

(

const rational &

num

)

[inline]

Convertidor a punto fijo.

Definición en la línea 242 del archivo rational.h.

bool ADH::check_ok_externo

(

const rational &

r

)

bool ADH::check_ok

(

const rational &

r

)

Verifica la invariante de la clase rational.

Rep Modelo de la clase:

    +---+
    | 3 | <==  m_num == numerador del número racional
    +---+
    |134| <==  m_den == denominador del número racional
    +---+

• http://www.di-mare.com/adolfo/binder/c03.htm#k1-Rep

Comentarios:

Libera al programador de implementar el método Ok()

• http://www.di-mare.com/adolfo/binder/c04.htm#sc11

• Invariante: ningún objeto puede estar almacenado en la posición nula.

• Invariante: el denominador debe ser un número positivo.

• Invariante: el cero debe representarse con denominador igual a "1".

• Invariante: el numerador y el denominador deben ser primos relativos.

Definición en la línea 34 del archivo rational.cpp.

bool ADH::check_ok_no_Rep

(

const rational &

r

)

Verifica la invariante de la clase rational.

Comentarios:

Esta implementación nos se le mete al Rep (casi siempre no es posible implementar una función como ésta).

• http://www.di-mare.com/adolfo/binder/c03.htm#k1-Rep

Libera al programador de implementar el método Ok()

• http://www.di-mare.com/adolfo/binder/c04.htm#sc11

• Invariante: ningún objeto puede estar almacenado en la posición nula.

• Invariante: el denominador debe ser un número positivo.

• Invariante: el cero debe representarse con denominador igual a "1".

• Invariante: el numerador y el denominador deben ser primos relativos.

Definición en la línea 69 del archivo rational.cpp.

std::ostream& ADH::operator<<	(	std::ostream &	COUT,
		const rational &	r
	)

Graba el valor de "r" en el flujo "COUT".

• Graba el valor en el formato [num/den].
• En particular, este es el operador que se invoca cuando se usa, por ejemplo, este tipo de instrucción:

            cout << r << q;
  

Definición en la línea 247 del archivo rational.cpp.

std::istream& ADH::operator>>	(	std::istream &	CIN,
		rational &	r
	)

Lee del flujo de texto "CIN" el valor de "r".

Precondición:

El número rational debe haber sido escrito usando el formato "[r/den]", aunque es permisible usar algunos blancos.

• Se termina de leer el valor sólo cuando encuentra "]".
• [ -+-+-+-+- 4 / -- -+ -- 32 ] se lee como [1/8]

Definición en la línea 264 del archivo rational.cpp.

rational ADH::operator+	(	const rational &	x,
		const rational &	y
	)

"x+y".

• Calcula y retorna la suma "x+y".

Definición en la línea 334 del archivo rational.cpp.

rational ADH::operator-	(	const rational &	x,
		const rational &	y
	)

"x-y".

• Calcula y retorna la resta "x-y".

Definición en la línea 344 del archivo rational.cpp.

rational ADH::operator*	(	const rational &	x,
		const rational &	y
	)

"x*y".

• Calcula y retorna la multiplicación "x*y".

Definición en la línea 355 del archivo rational.cpp.

rational ADH::operator/	(	const rational &	x,
		const rational &	y
	)

"x/y".

• Calcula y retorna la división "x/y".

  Precondición:

  y != 0

Definición en la línea 367 del archivo rational.cpp.