|
Interface: StringMan Arquivos: lib/stringman.h Última atualização: 11/02/2002 Autor: Luiz Henrique Shigunov |
Descrição |
| Funções | |
|
|
|
Esta página descreve a interface StringMan.
Esta interface fornece várias funções para manipular strings.
int Compare(const char *s1, const char *s2);
Esta função compara s1 com s2.
void Concatenate(char *dest, const char *src);
Esta função concatena src em dest sobrescrevendo o 0 do final de dest e, por fim, colocando 0 no final de dest.
As strings não podem se sobrepor e dest tem que ser grande o suficiente.
void Copy(char *dest, const char *src);
Esta função copia a string apontada por src (incluindo o 0 final) para a string apontada por dest.
As strings não podem se sobrepor e dest tem que ser grande o suficiente.
char *FindChar(const char *s, int c);
Esta função encontra a primeira ocorrência do caracter c na string s.
char *FindLastChar(const char *s, int c);
Esta função encontra a última ocorrência do caracter c na string s.
unsigned int Length(const char *s);
Esta função calcula o tamanho da string s não incluindo o último zero.
int NCompare(const char *s1, const char *s2, unsigned int count);
Esta função compara count bytes de s1 com s2.
void NConcatenate(char *dest, const char *src, unsigned int count);
Esta função concatena count bytes de src em dest sobrescrevendo o 0 do final de dest.
As strings não podem se sobrepor e dest tem que ser grande o suficiente.
void NCopy(char *dest, const char *src, unsigned int count);
Esta função copia count bytes da string apontada por src para a string apontada por dest.
As strings não podem se sobrepor e dest tem que ser grande o suficiente.
No caso de src ser menor que count, o resto de dest será preenchido com zeros.
int BufPrintF(char *buf, const char *fmt, ...);
Esta função coloca em buf a string formatada de acordo com fmt. Os 3 pontos significam que podem vir uma quantidade variável de parâmetros.
int BufPrintFArgs(char *buf, const char *fmt, va_list args);
Esta função coloca em buf a string formatada de acordo com fmt. args é um vetor com os parâmetros.
O arquivo stdarg.h deve ser incluído. É nesse arquivo que va_list é definido.
long int StrToInt(const char *str, char **endstr, int base, int *error);
Esta função converte a string str para um valor long int de acordo com a base base.
A string deve começar com um número qualquer de espaço (' ', '\n', '\t', '\r', '\f', '\v') seguido de um sinal '+' ou '-'. Se base for 0 ou 16, a string pode ter um prefixo '0x', e o número será lido com base 16.
Se base for 0 e o número começar com 0, a base será 8 (octal), do contrário base 10.
A conversão termina no primeiro caracter inválido para a base.
endstr, se for diferente de NULL, indica o fim da str convertida. Se ocorrer erro, este será indicado em error.
base deve ser >= 2 e <= 36. Se base for 0 a base será descoberta.