libpdsca: Funciones del módulo PdsCVector.

Estructuras de datos
struct	PdsCVector
	La estructura tipo PdsCVector . Esta estructura genera un vector de Nel elementos. Para usar incluir pds/pdsca.h. Más...

pds_cvector_new
Creando Nuevos vectores
PdsCVector *	pds_cvector_new (PdsCaNatural Nel)
	Crea un vector de tipo PdsCVector e inicia con cero todos los elementos. Más...

PdsCVector *	pds_cvector_new_cvector (const PdsCVector *VecSrc)
	Crea un vector de tipo PdsCVector usando como fuente el vector VecSrc. Más...

PdsCVector *	pds_cvector_new_vector (const PdsVector *VecSrc)
	Crea un vector de tipo PdsCVector usando como fuente el vector VecSrc y lo copia en la parte real del vector creado. Más...

pds_cvector_init
Iniciando el todo el vector con un valor
int	pds_cvector_init_complex (PdsCVector *Vector, PdsComplex Val)
	Inicia el vector de tipo puntero PdsCVector. Vector=Val. Más...

int	pds_cvector_init_real (PdsCVector *Vector, PdsCaReal Val)
	Inicia la parte real del vector de tipo puntero PdsCVector. Vector.Real=Val. Más...

int	pds_cvector_init_imag (PdsCVector *Vector, PdsCaReal Val)
	Inicia la parte imaginaria del vector de tipo puntero PdsCVector. Vector.Imag=Val. Más...

int	pds_cvector_init_cvector (PdsCVector Vector, const PdsCVector VecSrc)
	Inicia el vector de tipo puntero PdsCVector con otro vector. Si los tamaños son diferentes intersecta los tamaños y hace la copia en la intersección solamente. Vector=VecSrc. Más...

int	pds_cvector_init_rvector (PdsCVector Vector, const PdsVector VecSrc)
	Inicia la parte real del vector de tipo puntero PdsCVector con un vector de tipo PdsVector. Si los tamaños son diferentes intersecta los tamaños y hace la copia en la intersección solamente. Vector.Real=VecSrc. Más...

int	pds_cvector_init_ivector (PdsCVector Vector, const PdsVector VecSrc)
	Inicia la parte imaginaria del vector de tipo puntero PdsCVector con un vector de tipo PdsVector. Si los tamaños son diferentes intersecta los tamaños y hace la copia en la intersección solamente. Vector.Imag=VecSrc. Más...

pds_cvector_<printf>
Iprimiendo datos
int	pds_cvector_printf (const PdsCVector *Vector)
	Imprime en pantalla un vector de tipo puntero PdsCVector. Más...

int	pds_cvector_fprintf (const PdsCVector Vector, FILE fd)
	Imprime en el archivo que apunta fd un vector de tipo puntero PdsCVector. Más...

pds_cvector_get
Obteniendo datos
int	pds_cvector_get_complex (const PdsCVector Vector, PdsCaNatural x, PdsComplex m)
	Devuelve el valor complejo en la posición (x) del vector Vector. (x) inicia con (0). Más...

pds_cvector_set
Escribiendo datos
int	pds_cvector_set_complex (PdsCVector *Vector, PdsCaNatural x, PdsComplex m)
	Escribe el valor m en la posición (x) del vector Vector. (x) inicia con (0). Más...

int	pds_cvector_set_real (PdsCVector *Vector, PdsCaNatural x, PdsCaReal m)
	Escribe el valor m solo en la parte real de la posición (x) del vector Vector. (x) inicia con (0). Más...

int	pds_cvector_set_imag (PdsCVector *Vector, PdsCaNatural x, PdsCaReal m)
	Escribe el valor m solo en la parte imaginaria de la posición (x) del vector Vector. (x) inicia con (0). Más...

pds_cvector_<operation>
Escribiendo datos
int	pds_cvector_conjugate (PdsCVector *Vector)
	Encuentra el conjugado del vector Vector. Vector=CONJ(Vector). Más...

int	pds_cvector_conjugate_cvector (const PdsCVector Vector, PdsCVector VecDest)
	Encuentra el conjugado del vector Vector, y el resultado es copiado en el vector VecDest. VecDest=CONJ(Vector). Más...

int	pds_cvector_modulus (const PdsCVector Vector, PdsVector VecDest)
	Encuentra el Modulo del vector Vector, y el resultado es copiado en el vector VecDest. VecDest=\|Vector\|. Más...

int	pds_cvector_modulus2 (const PdsCVector Vector, PdsVector VecDest)
	Encuentra el Modulo^2 del vector Vector, y el resultado es copiado en el vector VecDest. VecDest=\|Vector\|^2. Más...

int	pds_cvector_phase (const PdsCVector Vector, PdsVector VecDest)
	Encuentra la fase de Z=X+Yi phase=atan2(Y,X) del vector Vector, y el resultado es copiado en el vector VecDest. VecDest=Phase{Vector}. Más...

pds_cvector_<free>
Escribiendo datos
void	pds_cvector_free (PdsCVector *Vector)
	Libera un vector de tipo puntero PdsCVector. Más...

void	pds_cvector_destroy (PdsCVector **Vector)
	Libera un vector de tipo puntero PdsCVector, y limpia el puntero con NULL. Más...

Descripción detallada

Documentación de las funciones

PdsCVector * pds_cvector_new ( PdsCaNatural Nel )

Crea un vector de tipo PdsCVector e inicia con cero todos los elementos.

Parámetros

[in] Nel Es el número de elementos del vector.

Devuelve: Un puntero al vector de tipo PdsCVector.

Ejemplos:: testprograma.c.

PdsCVector * pds_cvector_new_cvector ( const PdsCVector * VecSrc )

Crea un vector de tipo PdsCVector usando como fuente el vector VecSrc.

Parámetros

[in] VecSrc Es el vector imagen que se usará como fuente.

Devuelve: Un puntero al vector de tipo PdsCVector, retorna NULL en caso de error.

PdsCVector * pds_cvector_new_vector ( const PdsVector * VecSrc )

Crea un vector de tipo PdsCVector usando como fuente el vector VecSrc y lo copia en la parte real del vector creado.

Parámetros

[in] VecSrc Es el vector imagen que se usará como fuente.

Devuelve: Un puntero al vector de tipo PdsCVector, retorna NULL en caso de error.

int pds_cvector_init_complex	(	PdsCVector *	Vector,
		PdsComplex	Val
	)

Inicia el vector de tipo puntero PdsCVector.
Vector=Val.

Parámetros

[in,out]	Vector	El vector a iniciar.
[in]	Val	Es el valor complejo inicial de los elementos.

Devuelve: TRUE si todo fue bien o FALSE si no.

Ejemplos:: testprograma.c.

int pds_cvector_init_real	(	PdsCVector *	Vector,
		PdsCaReal	Val
	)

Inicia la parte real del vector de tipo puntero PdsCVector.
Vector.Real=Val.

Parámetros

[in,out]	Vector	El vector a iniciar.
[in]	Val	Es el valor real inicial de los elementos.

Devuelve: TRUE si todo fue bien o FALSE si no.

int pds_cvector_init_imag	(	PdsCVector *	Vector,
		PdsCaReal	Val
	)

Inicia la parte imaginaria del vector de tipo puntero PdsCVector.
Vector.Imag=Val.

Parámetros

[in,out]	Vector	El vector a iniciar.
[in]	Val	Es el valor imaginario inicial de los elementos.

Devuelve: TRUE si todo fue bien o FALSE si no.

int pds_cvector_init_cvector	(	PdsCVector *	Vector,
		const PdsCVector *	VecSrc
	)

Inicia el vector de tipo puntero PdsCVector con otro vector. Si los tamaños son diferentes intersecta los tamaños y hace la copia en la intersección solamente.
Vector=VecSrc.

Parámetros

[in,out]	Vector	Es el vector a iniciar.
[in]	VecSrc	Es el vector fuente de la copia.

Devuelve: TRUE si todo fue bien o FALSE si no.

int pds_cvector_init_rvector	(	PdsCVector *	Vector,
		const PdsVector *	VecSrc
	)

Inicia la parte real del vector de tipo puntero PdsCVector con un vector de tipo PdsVector. Si los tamaños son diferentes intersecta los tamaños y hace la copia en la intersección solamente.
Vector.Real=VecSrc.

Parámetros

[in,out]	Vector	Es el vector a iniciar la parte real.
[in]	VecSrc	Es el vector fuente de la copia.

Devuelve: TRUE si todo fue bien o FALSE si no.

int pds_cvector_init_ivector	(	PdsCVector *	Vector,
		const PdsVector *	VecSrc
	)

Inicia la parte imaginaria del vector de tipo puntero PdsCVector con un vector de tipo PdsVector. Si los tamaños son diferentes intersecta los tamaños y hace la copia en la intersección solamente.
Vector.Imag=VecSrc.

Parámetros

[in,out]	Vector	Es el vector a iniciar la parte imaginaria.
[in]	VecSrc	Es el vector fuente de la copia.

Devuelve: TRUE si todo fue bien o FALSE si no.

int pds_cvector_printf ( const PdsCVector * Vector )

Imprime en pantalla un vector de tipo puntero PdsCVector.

Parámetros

[in] Vector El vector a imprimir en pantalla.

Devuelve: TRUE si todo fue bien o FALSE si no.

Ejemplos:: testprograma.c.

int pds_cvector_fprintf	(	const PdsCVector *	Vector,
		FILE *	fd
	)

Imprime en el archivo que apunta fd un vector de tipo puntero PdsCVector.

Parámetros

[in]	Vector	El vector a imprimir en pantalla.
[in,out]	fd	El puntero al archivo.

Devuelve: TRUE si todo fue bien o FALSE si no.

int pds_cvector_get_complex	(	const PdsCVector *	Vector,
		PdsCaNatural	x,
		PdsComplex *	m
	)

Devuelve el valor complejo en la posición (x) del vector Vector. (x) inicia con (0).

Parámetros

[in]	Vector	El vector en consulta.
[in]	x	Posición x, el primer valor de x es cero.
[out]	m	El valor complejo en la posición (x), en caso de error por fuera de rango (x) entonces carga 0+0i en m, en caso de error de vector nulo carga 0+0i en m.

Devuelve: TRUE si todo fue bien o FALSE si no (ej: Vector==NULL).

int pds_cvector_set_complex	(	PdsCVector *	Vector,
		PdsCaNatural	x,
		PdsComplex	m
	)

Escribe el valor m en la posición (x) del vector Vector. (x) inicia con (0).

Parámetros

[in,out]	Vector	El vector a escribir.
[in]	x	Posición x, el primer valor de x es cero.
[in]	m	El valor complejo en la posición (x), en caso de error por fuera de rango (x) entonces no hace nada y no se considera como error.

Devuelve: TRUE si todo fue bien o FALSE si no (ej: Vector==NULL).

int pds_cvector_set_real	(	PdsCVector *	Vector,
		PdsCaNatural	x,
		PdsCaReal	m
	)

Escribe el valor m solo en la parte real de la posición (x) del vector Vector. (x) inicia con (0).

Parámetros

[in,out]	Vector	El vector a escribir.
[in]	x	Posición x, el primer valor de x es cero.
[in]	m	La parte real a escribir en la posición (x), en caso de error por fuera de rango (x) entonces no hace nada y no se considera como error.

Devuelve: TRUE si todo fue bien o FALSE si no (ej: Vector==NULL).

Ejemplos:: testprograma.c.

int pds_cvector_set_imag	(	PdsCVector *	Vector,
		PdsCaNatural	x,
		PdsCaReal	m
	)

Escribe el valor m solo en la parte imaginaria de la posición (x) del vector Vector. (x) inicia con (0).

Parámetros

[in,out]	Vector	El vector a escribir.
[in]	x	Posición x, el primer valor de x es cero.
[in]	m	La parte imaginaria a escribir en la posición (x), en caso de error por fuera de rango (x) entonces no hace nada y no se considera como error.

Devuelve: TRUE si todo fue bien o FALSE si no (ej: Vector==NULL).

Ejemplos:: testprograma.c.

int pds_cvector_conjugate ( PdsCVector * Vector )

Encuentra el conjugado del vector Vector.
Vector=CONJ(Vector).

Parámetros

[in,out] Vector Es el vector a obtener el conjugado.

Devuelve: TRUE si todo fue bien o FALSE si no, por ejemplo vector NULL o tamanhos distintos.

int pds_cvector_conjugate_cvector	(	const PdsCVector *	Vector,
		PdsCVector *	VecDest
	)

Encuentra el conjugado del vector Vector, y el resultado es copiado en el vector VecDest.
VecDest=CONJ(Vector).

Parámetros

[in]	Vector	Es el vector a obtener el conjugado.
[in,out]	VecDest	Es el conjugado del vector Vector.

Devuelve: TRUE si todo fue bien o FALSE si no, por ejemplo vector NULL o tamanhos distintos.

int pds_cvector_modulus	(	const PdsCVector *	Vector,
		PdsVector *	VecDest
	)

Encuentra el Modulo del vector Vector, y el resultado es copiado en el vector VecDest.
VecDest=|Vector|.

Parámetros

[in]	Vector	Es el vector a obtener el modulo.
[in,out]	VecDest	Es el módulo del vector Vector.

Devuelve: TRUE si todo fue bien o FALSE si no, por ejemplo vector NULL o tamanhos distintos.

int pds_cvector_modulus2	(	const PdsCVector *	Vector,
		PdsVector *	VecDest
	)

Encuentra el Modulo^2 del vector Vector, y el resultado es copiado en el vector VecDest.
VecDest=|Vector|^2.

Parámetros

[in]	Vector	Es el vector a obtener el modulo^2.
[in,out]	VecDest	Es el módulo^2 del vector Vector.

Devuelve: TRUE si todo fue bien o FALSE si no, por ejemplo vector NULL o tamanhos distintos.

int pds_cvector_phase	(	const PdsCVector *	Vector,
		PdsVector *	VecDest
	)

Encuentra la fase de Z=X+Yi phase=atan2(Y,X) del vector Vector, y el resultado es copiado en el vector VecDest.
VecDest=Phase{Vector}.

Parámetros

[in,out]	Vector	Es el vector a obtener la fase.
[in]	VecDest	Es la fase del vector Vector.

Devuelve: TRUE si todo fue bien o FALSE si no, por ejemplo vector NULL o tamanhos distintos.

void pds_cvector_free ( PdsCVector * Vector )

Libera un vector de tipo puntero PdsCVector.

Parámetros

[in,out] Vector El vector a liberar.

Devuelve: No retorna valor.

Ejemplos:: testprograma.c.

void pds_cvector_destroy ( PdsCVector ** Vector )

Libera un vector de tipo puntero PdsCVector, y limpia el puntero con NULL.

Parámetros

[in,out] Vector El vector a liberar y limpiar.

Devuelve: No retorna valor.

Estructuras de datos

pds_cvector_new

pds_cvector_init

pds_cvector_<printf>

pds_cvector_get

pds_cvector_set

pds_cvector_<operation>

pds_cvector_<free>

Descripción detallada

Documentación de las funciones

Enlaces de interés