Funciones del módulo PdsString.

Funciones
char *	pds_string_new_from_file (const char *path)
	Esta función retorna una cadena de caracteres con el contenido de un archivo. Más...

pds_<std*_variations>
Funciones variantes de stdlib y stdio.
char *	pds_strcat_cell_string (const PdsCellString *celldata, const char *separator)
	Esta función retorna una cadena de caracteres con el contenido concatenado usando como separador separator. Más...
char *	pds_sprintf (const char *format,...)
	Similar a sprintf pero esta retorna un puntero a una nueva cadena con el texto. Más...
PdsCellString *	pds_strsep_cell_string (const char *str, const char *delim)
	Esta función es similar a la función strsep, donde la cadena str es dividida usando algunos de los delimitadores especificados en delim. Los pedazos son cargados en una estructura PdsCellString* retornada por la función. Más...
int	pds_strcicmp (const char *str0, const char *str1)
	Esta función es similar a la función strcmp pero no distinguiendo mayúsculas y minúsculas (Case Insensitive), donde si las cadenas son iguales la funcion retorna 0. Más...

pds_string_<type>_clean_<location>
Funciones para limpiar strings.
int	pds_string_multi_clean_beginning (char *str, const char *pat)
	Esta función limpia los primeros caracteres de la cadena str que contengan algun caracter en pat, la cadena no es realocada simplemente los datos son movidos de lugar. Más...
int	pds_string_multi_clean_ending (char *str, const char *pat)
	Esta función limpia los ultimos caracteres de la cadena str que contengan algun caracter en pat, la cadena no es realocada simplemente los datos son cerados. Más...
int	pds_string_clean_beginning (char *str, char c)
	Esta función limpia los primeros caracteres de la cadena str que contengan el caracter c, la cadena no es realocada simplemente los datos son movidos de lugar. Más...
int	pds_string_clean_ending (char *str, char c)
	Esta función limpia los ultimos caracteres de la cadena str que contengan el caracter c, la cadena no es realocada simplemente los datos son cerados. Más...

pds_string_<work_with_patterns>
Funciones para limpiar strings.
int	pds_string_how_many_times (const char *str, const char *pat)
	Esta función cuenta la cantidad de coincidencias de la cadena pat en la cadena str. Más...
char *	pds_string_new_with_replacement (const char *str, const char *pat, const char *rep)
	Esta función busca en una cadena str un patrón pat y los remplaza con el contenido de la cadena rep, el resultado es retornado en una nueva cadena;. Más...
char *	pds_string_new_rawdata_after_match (const char *str, const char *pat_open, const char *pat_close, char **str_ptr)
	Esta función busca en una cadena str, los datos entre un patrón pat_open y uno pat_close. Retorna los datos en una nueva cadena de texto. Más...

Descripción detallada

Funciones.

Documentación de las funciones

pds_string_new_from_file()

char * pds_string_new_from_file

(

const char *

path

)

Esta función retorna una cadena de caracteres con el contenido de un archivo.

Parámetros

[in]

path

El archivo a leer.

Devuelve

Retorna una cadena de caracteres con el contenido de un archivo. O NULL en caso de error.

Ejemplos:

testpdsstring.c.

pds_strcat_cell_string()

char * pds_strcat_cell_string	(	const PdsCellString *	celldata,
		const char *	separator
	)

Esta función retorna una cadena de caracteres con el contenido concatenado usando como separador separator.

"str1"separator"str2"separator ... separator"strN"

Parámetros

[in]	celldata	La estructura a concatenar.
[in]	separator	Separador usado entre celulas.

Devuelve

Retorna una nueva cadena de caracteres con el contenido concatenado. O NULL en caso de error.

Ver también

pds_cell_string_joint()

pds_cell_string_joint_with_end()

Ejemplos:

testpdsstring.c.

pds_sprintf()

char * pds_sprintf	(	const char *	format,
			...
	)

Similar a sprintf pero esta retorna un puntero a una nueva cadena con el texto.

Parámetros

[in]	format	Formato de texto de salida.
[in]	...	Otros argumentos.

Devuelve

Retorna un puntero a una nueva cadena con el texto.

Ejemplos:

testpdsstring.c.

pds_strsep_cell_string()

PdsCellString * pds_strsep_cell_string	(	const char *	str,
		const char *	delim
	)

Esta función es similar a la función strsep, donde la cadena str es dividida usando algunos de los delimitadores especificados en delim. Los pedazos son cargados en una estructura PdsCellString* retornada por la función.

Parámetros

[in]	str	Cadena a dividir, esta cadena no sera modificada.
[in]	delim	Delimitadores a usar. Si delim es NULL la función retorna NULL. Si delim es una cadena vacia es retornada la cadena entera dentro de una PdsCellString.

Devuelve

Retorna un puntero a una nueva estructura de tipo PdsCellString *, con los tokens de la división.

Ejemplos:

testpdsstring.c.

pds_strcicmp()

int pds_strcicmp	(	const char *	str0,
		const char *	str1
	)

Esta función es similar a la función strcmp pero no distinguiendo mayúsculas y minúsculas (Case Insensitive), donde si las cadenas son iguales la funcion retorna 0.

Parámetros

[in]	str0	Primera cadena a comparar.
[in]	str1	Segunda cadena a comparar.

Devuelve

Retorna 0 si las cadenas son iguales (Case Insensitive).

Ejemplos:

testpdsstring.c.

pds_string_multi_clean_beginning()

int pds_string_multi_clean_beginning	(	char *	str,
		const char *	pat
	)

Esta función limpia los primeros caracteres de la cadena str que contengan algun caracter en pat, la cadena no es realocada simplemente los datos son movidos de lugar.

Parámetros

[in]	str	Cadena a limpiar.
[in]	pat	Caracteres a limpiar.

Devuelve

Retorna TRUE si las cadena fue limpiada correctamente o retorna FALSE si str o pat es igual a NULL;

Ejemplos:

testpdsstring.c.

pds_string_multi_clean_ending()

int pds_string_multi_clean_ending	(	char *	str,
		const char *	pat
	)

Esta función limpia los ultimos caracteres de la cadena str que contengan algun caracter en pat, la cadena no es realocada simplemente los datos son cerados.

Parámetros

[in]	str	Cadena a limpiar.
[in]	pat	Caracteres a limpiar.

Devuelve

Retorna TRUE si las cadena fue limpiada correctamente o retorna FALSE si str o pat es igual a NULL;

Ejemplos:

testpdsstring.c.

pds_string_clean_beginning()

int pds_string_clean_beginning	(	char *	str,
		char	c
	)

Esta función limpia los primeros caracteres de la cadena str que contengan el caracter c, la cadena no es realocada simplemente los datos son movidos de lugar.

Parámetros

[in]	str	Cadena a limpiar.
[in]	c	Caracter a limpiar.

Devuelve

Retorna TRUE si las cadena fue limpiada correctamente o retorna FALSE si str es igual a NULL;

pds_string_clean_ending()

int pds_string_clean_ending	(	char *	str,
		char	c
	)

Esta función limpia los ultimos caracteres de la cadena str que contengan el caracter c, la cadena no es realocada simplemente los datos son cerados.

Parámetros

[in]	str	Cadena a limpiar.
[in]	c	Caracter a limpiar.

Devuelve

Retorna TRUE si las cadena fue limpiada correctamente o retorna FALSE si str es igual a NULL;

pds_string_how_many_times()

int pds_string_how_many_times	(	const char *	str,
		const char *	pat
	)

Esta función cuenta la cantidad de coincidencias de la cadena pat en la cadena str.

Cuando encuentra una coincidencia en la posición p0 de str, continua la siguiente búsqueda en p0+strlen(path).

Parámetros

[in]	str	Cadena donde se realizará la búsqueda.
[in]	pat	Patrona buscar.

Devuelve

Retorna el número de coincidencias o -1 en caso de error.

pds_string_new_with_replacement()

char * pds_string_new_with_replacement	(	const char *	str,
		const char *	pat,
		const char *	rep
	)

Esta función busca en una cadena str un patrón pat y los remplaza con el contenido de la cadena rep, el resultado es retornado en una nueva cadena;.

Cuando encuentra una coincidencia en la posición p0 de str, continua la siguiente búsqueda en p0+strlen(pat).

Parámetros

[in]	str	Cadena donde se realizará la búsqueda.
[in]	pat	Patrón a buscar.
[in]	rep	Patrón a de remplazo.

Devuelve

Retorna una nueva cadena con el resultado de remplazar pat por rep en str.

pds_string_new_rawdata_after_match()

char * pds_string_new_rawdata_after_match	(	const char *	str,
		const char *	pat_open,
		const char *	pat_close,
		char **	str_ptr
	)

Esta función busca en una cadena str, los datos entre un patrón pat_open y uno pat_close. Retorna los datos en una nueva cadena de texto.

Cuando encuentra una coincidencia la posición inmediata después de pat_close es cargada en str_ptr (solo si esa variable str_ptr existe).

Ejemplos : Busca la coincidencia y además es cargado str_ptr con la dirección inmediata a la coincidencia con pat_close.

char str[]="hola <b> Fernando\n</b> como estas";
char *str_ptr=NULL;
char *rawdata=pds_string_new_rawdata_after_match(str,"<b>","</b>",&str_ptr);

Ejemplos : Busca la coincidencia en str.

char str[]="hola <b> Fernando\n</b> como estas";
char *rawdata=pds_string_new_rawdata_after_match(str,"<b>","</b>",NULL);

Parámetros

[in]	str	Cadena donde se realizará la búsqueda.
[in]	pat_open	Patrón de apertura.
[in]	pat_close	Patrón de finalización.
[out]	str_ptr	puntero en cuyo contenido se grabará la dirección de la dirección de memoria en str después de pat_close. Si se retorna un str_ptr==NULL significa que se llegó al final de la cadena. Este solo es una dirección de memoria de str y no debe ser liberada.

Devuelve

Retorna una nueva cadena con el contenido entre pat_open y pat_close.

Ejemplos:

testpdsstring2.c.