Módulo de trabajo con string.h


Funciones

void * memchr (const void *s, int c, size_t n)
 Localiza la primera aparición del caracter c (convertido a unsigned char) en los primeros n caracteres (cada uno interpretado como un unsigned char) del objeto apuntado por s.
int memcmp (const void *s1, const void *s2, size_t n)
 Compara los primeros n caracteres del objeto apuntado por s1 (interpretado como unsigned char) con los primeros n caracteres del objeto apuntado por s2 (interpretado como unsigned char).
void * memcpy (void *s1, const void *s2, size_t n)
 Copia los primeros n caracteres del objeto apuntado por s2 al objeto apuntado por s1.
void * memmove (void *s1, const void *s2, size_t n)
 Copia los primeros n caracteres del objeto apuntado por s2 al objeto apuntado por s1.
void * memset (void *s, int c, size_t n)
 Copia el valor de c (convertido a unsigned char) en cada uno de los primeros n caracteres en el objeto apuntado por s.
char * strcat (char *s1, const char *s2)
 Añade una copia de la cadena apuntada por s2 (incluyendo el caracter nulo) al final de la cadena apuntada por s1. El carácter inicial de s2 sobrescribe el caracter nulo al final de s1.
char * strchr (const char *s, int c)
 Localiza la primera aparicion de c (convertido a unsigned char) en la cadena apuntada por s (incluyendo el caracter nulo).
int strcmp (const char *s1, const char *s2)
 Compara la cadena apuntada por s1 con la cadena apuntada por s2.
int strcoll (const char *s1, const char *s2)
 -----
char * strcpy (char *s1, const char *s2)
 Copia la cadena apuntada por s2 (incluyendo el carácter nulo) a la cadena apuntada por s1.
size_t strcspn (const char *s1, const char *s2)
 Cuenta el numero de caracteres de una subcadena inicial apuntada por s1 que no contenga ninguno de los caracteres en la cadena apuntada por s2.
char * strerror (int errnum)
 Convierte el numero de error en errnum a un mensaje de error (una cadena de caracteres).
size_t strlen (const char *s)
 Calcula el numero de caracteres de la cadena apuntada por s.
char * strncat (char *s1, const char *s2, size_t n)
 Añade no más de n caracteres (un caracter nulo y los demas caracteres siguientes no son añadidos) de la cadena apuntada por s2 al final de la cadena apuntada por s1. El caracter inicial de s2 sobrescribe el caracter nulo al final de s1. El caracter nulo siempre es añadido al resultado.
int strncmp (const char *s1, const char *s2, size_t n)
 Compara no más de n caracteres (caracteres posteriores al caracter nulo no se tienen en cuenta) de la cadena apuntada por s1 con la cadena apuntada por s2.
char * strncpy (char *s1, const char *s2, size_t n)
 Copia no mas de n caracteres (caracteres posteriores al caracter nulo no son copiados) de la cadena apuntada por s2 a la cadena apuntada por s1.
char * strpbrk (const char *s1, const char *s2)
 Localiza la primera aparicion de la cadena apuntada por s1 de cualquier caracter de la cadena apuntada por s2.
char * strrchr (const char *s, int c)
 Localiza la última aparición de c (convertido a unsigned char) en la cadena apuntada por s (incluyendo el carácter nulo).
size_t strspn (const char *s1, const char *s2)
 devuelve la posición del primer carácter de una cadena que no coincide con ninguno de los caracteres de otra cadena dada.
char * strstr (const char *s1, const char *s2)
 Busca una cadena dentro de otra.
char * strtok (char *s1, const char *s2)
 -----
size_t strxfrm (char *s1, const char *s2, size_t n)
 -----

Descripción detallada

se puede encontrar un ejemplo de uso en ej_string.c

Documentación de las funciones

void * memchr ( const void *  s,
int  c,
size_t  n 
)

Localiza la primera aparición del caracter c (convertido a unsigned char) en los primeros n caracteres (cada uno interpretado como un unsigned char) del objeto apuntado por s.

Parámetros:
s,: Se buscara en esta direccion
c,: Caracter a buscar
n,: Se buscara en los n primeros caracteres
Devuelve:
La función retorna un puntero al carácter localizado, o un puntero nulo si el caracter no apareció en el objeto.

int memcmp ( const void *  s1,
const void *  s2,
size_t  n 
)

Compara los primeros n caracteres del objeto apuntado por s1 (interpretado como unsigned char) con los primeros n caracteres del objeto apuntado por s2 (interpretado como unsigned char).

Parámetros:
s1,: Primer objeto a comparar
s2,: Segundo objeto a comparar
n,: Se compara en los n primeros caracteres
Devuelve:
La función retorna un número entero mayor, igual, o menor que cero, apropiadamente segun el objeto apuntado por s1 es mayor, igual, o menor que el objeto apuntado por s2.

void * memcpy ( void *  s1,
const void *  s2,
size_t  n 
)

Copia los primeros n caracteres del objeto apuntado por s2 al objeto apuntado por s1.

Parámetros:
s1,: Primer objeto, destino
s2,: Segundo objeto, fuente
n,: Se copian los n primeros caracteres
Devuelve:
La función retorna el valor de s1. Si al copiar un objeto al otro se superponen, entonces el comportamiento no está definido.

void * memmove ( void *  s1,
const void *  s2,
size_t  n 
)

Copia los primeros n caracteres del objeto apuntado por s2 al objeto apuntado por s1.

Parámetros:
s1,: Primer objeto, destino
s2,: Segundo objeto, fuente
n,: Se copian los n primeros caracteres
Devuelve:
La funcion retorna el valor de s1. Si al copiar un objeto al otro se superponen, entonces el comportamiento no esta definido.

void * memset ( void *  s,
int  c,
size_t  n 
)

Copia el valor de c (convertido a unsigned char) en cada uno de los primeros n caracteres en el objeto apuntado por s.

Parámetros:
s,: Objeto destino
c,: Caracter a copiar
n,: Numero de veces caracteres
Devuelve:
La función retorna el valor de s.

char * strcat ( char *  s1,
const char *  s2 
)

Añade una copia de la cadena apuntada por s2 (incluyendo el caracter nulo) al final de la cadena apuntada por s1. El carácter inicial de s2 sobrescribe el caracter nulo al final de s1.

Parámetros:
s1,: Cadena destino.
s2,: Cadena Fuente.
Devuelve:
La funcion retorna el valor de s1. Si la copia hace que los objetos se superpongan, entonces el comportamiento no está definido.

char * strchr ( const char *  s,
int  c 
)

Localiza la primera aparicion de c (convertido a unsigned char) en la cadena apuntada por s (incluyendo el caracter nulo).

Parámetros:
s,: Cadena bajo busqueda
c,: Caracter a copiar
Devuelve:
La funcion retorna un puntero a partir del caracter encontrado. Si no se ha encontrado el caracter, c, entonces retorna un puntero null.

int strcmp ( const char *  s1,
const char *  s2 
)

Compara la cadena apuntada por s1 con la cadena apuntada por s2.

Parámetros:
s1,: Cadena 1
s2,: Cadena 2
Devuelve:
La función retorna un número entero mayor, igual, o menor que cero, apropiadamente segun la cadena apuntada por s1 es mayor, igual, o menor que la cadena apuntada por s2.

int strcoll ( const char *  s1,
const char *  s2 
)

-----

Parámetros:
s1,: -----
s2,: -----
Devuelve:
-----

char * strcpy ( char *  s1,
const char *  s2 
)

Copia la cadena apuntada por s2 (incluyendo el carácter nulo) a la cadena apuntada por s1.

Parámetros:
s1,: Cadena destino
s2,: Cadena fuente
Devuelve:
La funcion retorna el valor de s1. Si al copiar una cadena a la otra se superponen, entonces el comportamiento no esta definido.

size_t strcspn ( const char *  s1,
const char *  s2 
)

Cuenta el numero de caracteres de una subcadena inicial apuntada por s1 que no contenga ninguno de los caracteres en la cadena apuntada por s2.

Parámetros:
s1,: Cadena de busca
s2,: Cadena patron
Devuelve:
La funcion retorna el número de caracteres leidos de la subcadena hasta que halla alguno de los caracteres de s2. El carácter nulo no se cuenta.

char * strerror ( int  errnum  ) 

Convierte el numero de error en errnum a un mensaje de error (una cadena de caracteres).

Parámetros:
errnum,: Codigo del error.
Devuelve:
La función retorna la cadena de caracteres conteniendo el mensaje asociado con el numero de error. Esta conversión y el contenido del mensaje dependen de la implementacion. La cadena no sera modificada por el programa, pero si puede ser sobrescrito con otra llamada a la misma funcion.
Esta funcion no esta implementada debido a que gasta mucha memoria.

size_t strlen ( const char *  s  ) 

Calcula el numero de caracteres de la cadena apuntada por s.

Parámetros:
s,: cadena a contar
Devuelve:
La funcion retorna el numero de caracteres hasta el caracter nulo, que no se incluye.

char * strncat ( char *  s1,
const char *  s2,
size_t  n 
)

Añade no más de n caracteres (un caracter nulo y los demas caracteres siguientes no son añadidos) de la cadena apuntada por s2 al final de la cadena apuntada por s1. El caracter inicial de s2 sobrescribe el caracter nulo al final de s1. El caracter nulo siempre es añadido al resultado.

Parámetros:
s1,: cadena destino
s2,: cadena origen
n,: numero de caracteres a copiar
Devuelve:
La funcion retorna el numero de caracteres hasta el caracter nulo, que no se incluye.

int strncmp ( const char *  s1,
const char *  s2,
size_t  n 
)

Compara no más de n caracteres (caracteres posteriores al caracter nulo no se tienen en cuenta) de la cadena apuntada por s1 con la cadena apuntada por s2.

Parámetros:
s1,: Cadena 1
s2,: Cadena 2
n,: Numero de caracteres a comparar
Devuelve:
La funcion retorna un numero entero mayor, igual, o menor que cero, apropiadamente segun la cadena apuntada por s1 es mayor, igual, o menor que la cadena apuntada por s2.

char * strncpy ( char *  s1,
const char *  s2,
size_t  n 
)

Copia no mas de n caracteres (caracteres posteriores al caracter nulo no son copiados) de la cadena apuntada por s2 a la cadena apuntada por s1.

Parámetros:
s1,: Cadena 1
s2,: Cadena 2
n,: Numero de caracteres a comparar
Devuelve:
La funcion retorna el valor de s1. Si al copiar una cadena a la otra se superponen, entonces el comportamiento no esta definido. Si el array/arreglo apuntado por s2 es una cadena que es mas corta que n caracteres, entonces caracteres nulos son añadidos a la copia en el array apuntado por s1.

char * strpbrk ( const char *  s1,
const char *  s2 
)

Localiza la primera aparicion de la cadena apuntada por s1 de cualquier caracter de la cadena apuntada por s2.

Parámetros:
s1,: Cadena de busca
s2,: Cadena patron
Devuelve:
La funcion retorna un puntero al caracter, o un puntero nulo si ningun caracter de s2 aparecio en s1.

char * strrchr ( const char *  s,
int  c 
)

Localiza la última aparición de c (convertido a unsigned char) en la cadena apuntada por s (incluyendo el carácter nulo).

Parámetros:
s,: Cadena 1
c,: Caracter a buscar
Devuelve:
La funcion retorna un puntero a partir del caracter encontrado. Si no se ha encontrado el caracter, c, entonces retorna un puntero nulo.

size_t strspn ( const char *  s1,
const char *  s2 
)

devuelve la posición del primer carácter de una cadena que no coincide con ninguno de los caracteres de otra cadena dada.

Parámetros:
s1,: Objeto destino
s2,: Caracter a copiar
Devuelve:
La funcion devuelve la posición del primer carácter de una cadena que no coincide con ninguno de los caracteres de otra cadena dada.

char * strstr ( const char *  s1,
const char *  s2 
)

Busca una cadena dentro de otra.

Parámetros:
s1,: Cadena 1
s2,: Cadena 2
Devuelve:
La función retorna un puntero a la cadena encontrada, o un puntero nulo si no se encontró la cadena. Si s2 apunta a una cadena de longitud cero, la función retorna s1.

char * strtok ( char *  s1,
const char *  s2 
)

-----

Parámetros:
s1,: -----
s2,: -----
Devuelve:
-----

size_t strxfrm ( char *  s1,
const char *  s2,
size_t  n 
)

-----

Parámetros:
s1,: -----
s2,: -----
n,: -----
Devuelve:
-----


Generado el Thu Jan 8 00:56:55 2009 para pic-gcc-library por  doxygen 1.5.1