string.h

string.h è l'header file della libreria standard del C che contiene definizioni di macro, costanti e dichiarazioni di funzioni e tipi usati non solo nella manipolazione delle stringhe ma anche nella manipolazione della memoria.

Le funzioni dichiarate in string.h sono molto popolari ed essendo parte della libreria standard del C, il loro funzionamento è garantito su ogni piattaforma che supporta il linguaggio C. Tuttavia, l'esistenza di alcuni problemi di sicurezza con queste funzioni, come per esempio problemi di buffer overflow, portano i programmatori a scegliere delle varianti più sicure ma meno portabili. Inoltre le funzioni in questione lavorano solamente con caratteri ASCII o con un set di caratteri che lo estende in modo compatibile come l'ISO 8859-1. La gestione di stringhe non compatibili con l'ASCII viene generalmente risolto con l'uso della libreria wchar.h.

Costanti e tipi

Nome	Descrizione
NULL	Una macro che rappresenta la costante puntatore nullo; in altre parole, una costante che rappresenta un valore che è garantito essere l'indirizzo di una posizione non valida nella memoria.
size_t	Un intero senza segno restituito dell'operatore sizeof.

Funzioni

Nome	Descrizione
void *memcpy(void *dest, const void *src, size_t n);	Copia n bytes tra due aree di memoria che non devono sovrapporsi.
void *memmove(void *dest, const void *src, size_t n);	Copia n bytes tra due aree di memoria; a differenza di memcpy le aree di memoria possono sovrapporsi.
void *memchr(const void *s, int c, size_t n);	Ritorna un puntatore alla prima occorrenza di c in s, o NULL se c non compare tra i primi n caratteri di s.
int memcmp(const void *s1, const void *s2, size_t n);	Confronta i primi n caratteri di s1 con s2.
void *memset(void *s, int c, size_t n);	Colloca c nei primi n caratteri di s.
char *strcat(char *dest, const char *src);	Concatena src alla stringa dest.
char *strncat(char *dest, const char *src, size_t n);	Concatena al massimo n caratteri src alla stringa dest.
char *strchr(const char *s, int c);	Restituisce un puntatore alla prima occorrenza di c in s.
char *strrchr(const char *s, int c);	Restituisce un puntatore all'ultima occorrenza di c in s.
int strcmp(const char *s1, const char *s2);	Confronta la stringa s1 con s2.
int strncmp(const char *, const char *, size_t);	Confronta al massimo n caratteri della stringa s1 con s2.
int strcoll(const char *, const char *);	Confronta due stringhe utilizzando l'ordine lessicografico stabilito dalla localizzazione utilizzata
char *strcpy(char *s1, const char *s2);	Copia la stringa s2 nella stringa s1, incluso il carattere di terminazione \0.
char *strncpy(char *s1, const char *s2, size_t n);	Copia al massimo n caratteri della stringa s2 in s1.
char *strerror(int n);	Restituisce un puntatore alla stringa che corrisponde all'errore n.
size_t strlen(const char *s);	Restituisce la lunghezza della stringa s.
size_t strspn(const char *s, const char *accept);	Restituisce la lunghezza della prima istanza della stringa s di lunghezza massima composta esattamente dai caratteri definiti della stringa accept
size_t strcspn(const char *s, const char *reject);	Restituisce la lunghezza della porzione iniziale della stringa s di lunghezza massima composta esattamente da caratteri diversi da quelli della stringa reject
char *strpbrk(const char *s, const char *accept);	Restituisce la prima occorrenza di un carattere presente nella stringa s che sia uguale ad un qualsiasi carattere presente nella stringa accept
char *strstr(const char *haystack, const char *needle);	Trova la prima occorrenza della stringa needle all'interno della stringa haystack
char *strtok(char *s, const char *delimiters);	Spezza la stringa s in una serie di stringhe chiamate [token] in corrispondenza dei carattere delimitatore delimiters
size_t strxfrm(char *dest, const char *src, size_t n);	Trasforma la stringa puntata da src secondo la localizzazione in uso e copia i primi n caratteri di src nella stringa dest

Estensioni per ISO C

Nome	Descrizione	Specifica
char *strdup(const char *);	alloca e duplica una stringa nella memoria	POSIX; originariamente una estensione di BSD
errno_t strcpy_s(char *restrict s1, rsize_t s1max, const char *restrict s2);	variante di strcpy che include dei controlli sulla lunghezza delle stringhe	ISO/IEC WDTR 24731
void *mempcpy(void *dest, const void *src, size_t n);	variante di memcpy che ritorna un puntatore al byte successivo all'ultimo byte scritto	GNU
void *memccpy(void *dest, const void *src, int c, size_t n);	copia fino ad n byte fra due aree di memoria non sovrapposte, fermandosi quando viene trovato il byte c	UNIX 98?
int *strerror_r(int, char *, size_t);	restituisce una rappresentazione in stringa di un numero di errore (si veda errno) (thread-safe; alcune differenze semantiche fra la specifica GNU e XSI/POSIX)	GNU, POSIX
size_t strlcpy(char *dest, const char *src, size_t n);	variante di strcpy che comprende controlli sulla lunghezza della stringa	originariamente OpenBSD, ora anche FreeBSD, Solaris, OS X
char *strtok_r(char *, const char *, char **);	versione thread-safe di strtok	POSIX
char *strsignal(int sig);	analogamente a strerror, ritorna una rappresentazione in stringa del segnale sig (non thread safe)	varie distribuzioni BSD, Solaris, Linux

Altri progetti

Altri progetti

• Wikibooks

• Wikibooks contiene testi o manuali su String.h

Collegamenti esterni

• (EN) Operazioni su stringhe, su linux.die.net.