Extras Pds::Ra – String

Funciones con cadenas: Pds::Ra::ToString(), etc. Más...

Namespaces
namespace	Pds
	Nombre de espacion para PDS (Procesamiento Digital de Senales)
namespace	Pds::Ra
	Nombre de espacio para RA (Real Arrays)

Trabajar con cadenas de caracteres
Salva datos de matrices
bool	Pds::Ra::NaturalCompare (const std::string &str1, const std::string &str2)
	Esta función compara las cadenas str1 y str2 de forma natural (tomando en cuenta números). Más...
bool	Pds::Ra::IsSpacesString (const std::string &str)
	Esta función comprueba si los caracteres en la cadena son caracteres no visibles (white-spaces). Internamente usa la funcion isspace(). Más...
std::string	Pds::Ra::Trim (const std::string &str)
	Esta función retorna una cadena que elimina al inicio y al final algunos caracteres si estos son caracteres no visibles (white-spaces). Internamente usa la funcion isspace(). Más...
int	Pds::Ra::ElementsInString (const std::string &str)
	Retorna el número de elementos en la cadena. Internamente usa la funcion isspace(). Más...
std::list< std::string >	Pds::Ra::SplitString (std::string str, std::string delimeters)
	Retorna una lista con los elementos en la cadena. Internamente usa la funcion isspace(). Más...
template<typename T >
std::string	Pds::Ra::ToString (T val)
	Convierte en std::sring un int,long,unsigned int, unsigned long, float o double. Más...
bool	Pds::Ra::ArraySizeInString (std::string str, unsigned int &Nlin, unsigned int &Ncol)
	Retorna el número de lineas significativas y columnas de un archivo. Se asume que es un archivo de texto. Internamente usa la funcion isspace(). Más...
bool	Pds::Ra::SaveString (const std::string &filepath, const std::string &str)
	Save the string in a text file. Más...
bool	Pds::Ra::SaveVectorString (const std::string &filepath, const std::vector< std::string > &str)
	Save each string of a vector string in a new line in a text file. Más...
bool	Pds::Ra::PrintVectorString (const std::vector< std::string > &str)
	Print each string of a vector string in a new line in a text file. Más...

Descripción detallada

Funciones con cadenas: Pds::Ra::ToString(), etc.

#include <Pds/RaString>

Documentación de las funciones

NaturalCompare()

bool Pds::Ra::NaturalCompare	(	const std::string &	str1,
		const std::string &	str2
	)

Esta función compara las cadenas str1 y str2 de forma natural (tomando en cuenta números).

Parámetros

[in]	str1	Cadena a comparar.
[in]	str2	Cadena a comparar.

Devuelve

Retorna true si str1<str2 o false si no.

Ejemplos

example_ra_string_compare.cpp.

IsSpacesString()

bool Pds::Ra::IsSpacesString

(

const std::string &

str

)

Esta función comprueba si los caracteres en la cadena son caracteres no visibles (white-spaces). Internamente usa la funcion isspace().

Estos son:

' '     (0x20)  space (SPC)
'\t'    (0x09)  horizontal tab (TAB)
'\n'    (0x0a)  newline (LF)
'\v'    (0x0b)  vertical tab (VT)
'\f'    (0x0c)  feed (FF)
'\r'    (0x0d)  carriage return (CR)

Parámetros

[in]

str

Cadena a leer.

Devuelve

Retorna true si la cadena solo contiene white-spaces y false si no.

Ver también

isspace()

Trim()

std::string Pds::Ra::Trim

(

const std::string &

str

)

Esta función retorna una cadena que elimina al inicio y al final algunos caracteres si estos son caracteres no visibles (white-spaces). Internamente usa la funcion isspace().

Estos son:

' '     (0x20)  space (SPC)
'\t'    (0x09)  horizontal tab (TAB)
'\n'    (0x0a)  newline (LF)
'\v'    (0x0b)  vertical tab (VT)
'\f'    (0x0c)  feed (FF)
'\r'    (0x0d)  carriage return (CR)

Parámetros

[in]

str

Cadena a leer.

Devuelve

Retorna true si la cadena solo contiene white-spaces y false si no.

Ver también

isspace()

ElementsInString()

int Pds::Ra::ElementsInString

(

const std::string &

str

)

Retorna el número de elementos en la cadena. Internamente usa la funcion isspace().

Un elemento es un grupo de caracteres consecutivos que no contienen white-spaces:

' '     (0x20)  space (SPC)
'\t'    (0x09)  horizontal tab (TAB)
'\n'    (0x0a)  newline (LF)
'\v'    (0x0b)  vertical tab (VT)
'\f'    (0x0c)  feed (FF)
'\r'    (0x0d)  carriage return (CR)

Por ejemplo la siguiente cadena (str) contiene 3 elementos ("abc", "104","de10j"):

char str[]="abc  104\t\r\tde10j \n  ";

Parámetros

[in]

str

Cadena a testar.

Devuelve

Retorna el número de elementos en la cadena o negativo en caso de error.

Ver también

isspace()

SplitString()

std::list<std::string> Pds::Ra::SplitString	(	std::string	str,
		std::string	delimeters
	)

Retorna una lista con los elementos en la cadena. Internamente usa la funcion isspace().

Por ejemplo la siguiente cadena contiene 3 elementos ("abc", "104","de10j"):

char str[]="abc;104\tde10j";
 
std::list<std::string> token=Pds::Ra::SplitString(str,"\t;,");

Parámetros

[in]	str	Cadena a dividir.
[in]	delimeters	Cadena con posibles delimitadores.

Devuelve

Retorna una lista con los elementos separados por alguno de los delimitadores.

ToString()

template<typename T >

std::string Pds::Ra::ToString

(

T

val

)

Convierte en std::sring un int,long,unsigned int, unsigned long, float o double.

Parámetros

[in]

val

El elemento a convertir en std::string.

Devuelve

Retorna el valor convertido en std::string.

ArraySizeInString()

bool Pds::Ra::ArraySizeInString	(	std::string	str,
		unsigned int &	Nlin,
		unsigned int &	Ncol
	)

Retorna el número de lineas significativas y columnas de un archivo. Se asume que es un archivo de texto. Internamente usa la funcion isspace().

Una linea no significativa solo contiene white-spaces:

' '     (0x20)  space (SPC)
'\t'    (0x09)  horizontal tab (TAB)
'\n'    (0x0a)  newline (LF)
'\v'    (0x0b)  vertical tab (VT)
'\f'    (0x0c)  feed (FF)
'\r'    (0x0d)  carriage return (CR)

Parámetros

[in]	str	Cadena a leer.
[out]	Nlin	Variable donde se guardara el numero de lineas.
[out]	Ncol	Variable donde se guardara el numero de columnas.

Devuelve

Retorna true si todo fue bien o false si no. Si el numero de columnas no es constante entonces se retorna false. Si fue retornado false entonces Nlin y Ncol no son modificados.

Ver también

isspace()

SaveString()

bool Pds::Ra::SaveString	(	const std::string &	filepath,
		const std::string &	str
	)

Save the string in a text file.

Por ejemplo:

std::string str="abc;104\tde10j";
 
if(Pds::Ra::SaveString("filedat.txt",str))   sdt::cout<<"All OK\n";
else                                         std::cout<<"Error saving the file\n";

Parámetros

[in]	filepath	Direccion y nombre del archivo donde se escribira la cadena.
[in]	str	Cadena a escribir.

Devuelve

Retorna true si todo salio bien o false en caso de error.

Ejemplos

example_ra_file.cpp y example_vector_create.cpp.

SaveVectorString()

bool Pds::Ra::SaveVectorString	(	const std::string &	filepath,
		const std::vector< std::string > &	str
	)

Save each string of a vector string in a new line in a text file.

Por ejemplo:

std::vector<std::string> str={"hola","como","estas"};
 
if(Pds::Ra::SaveVectorString("filedat.txt",str))
    sdt::cout<<"All OK\n";
else
    std::cout<<"Error saving the file\n";

Parámetros

[in]	filepath	Direccion y nombre del archivo donde se escribira la cadena.
[in]	str	Cadena a escribir.

Devuelve

Retorna true si todo salio bien o false en caso de error.

PrintVectorString()

bool Pds::Ra::PrintVectorString

(

const std::vector< std::string > &

str

)

Print each string of a vector string in a new line in a text file.

Por ejemplo:

std::vector<std::string> str_vec={"hola","como","estas"};
 
Pds::Ra::PrintVectorString(str_vec)

Parámetros

[in]

str

Cadena a escribir.

Devuelve

Retorna true si todo salio bien o false en caso de error.