Sous-routine wstring

Objectif

Exécuter des opérations sur des chaînes de caractères larges.

Bibliothèque

Bibliothèque C standard (libc.a)

Syntaxe

Descriptif

Les sous-programmes Wstring copie, comparent et ajoutent des chaînes en mémoire, et déterminent l'emplacement, la taille et l'existence des chaînes en mémoire. Pour ces sous-routines, une chaîne est un tableau de caractères Wchar_t qui s'est terminé par un caractère nul. Les sous-routines Wstring sont parallèles aux sous-routines Chaîne , mais fonctionnent sur des chaînes de type Wchar_t plutôt que sur le type Char, sauf comme indiqué ci-dessous.

Les paramètres XString1, XString2et Chaîne XString indiquent les chaînes de type Wchar_t (tableaux de caractères Wchar terminés par un caractère Wchar_t null).

Les sous-programmes Wstrcat, Wstrncat, Wstrcpyet Wstrncpy modifient tous le paramètre XString1 . Ils ne vérient pas le débordement du tableau désigné par XString1. Tout mouvement de chaîne est exécuté de caractère large par un caractère large. Les mouvements de chevauchement vers le travail de gauche comme prévu, mais les mouvements qui se chevauchent vers la droite peuvent donner des résultats inattendus. Toutes ces sous-routines sont déclarées dans le fichier wstring.h .

La sous-routine Wstrcat ajoute une copie de la chaîne Wchar_t pointé par le paramètre XString2 à la fin de la chaîne Wchar_t pointé par le paramètre XString1 . La sous-routine Wstrcat renvoie un pointeur vers le résultat annulé.

La sous-routine Wstrncat copie, au maximum, la valeur du paramètre Numéro des caractères Wchar _ t dans le paramètre XString2 à la fin de la chaîne Wchar_t pointé par le paramètre XString1 . La copie s'arrête avant le caractère Numéro Wchar_t si un caractère null est rencontré dans la chaîne pointant vers le paramètre XString2 . La sous-routine Wstrncat renvoie un pointeur vers le résultat annulé.

La sous-routine Wstrcmp compare lexicographiquement la chaîne Wchar_t pointé par le paramètre XString1 à la chaîne Wchar_t pointée par le paramètre XString2 . La sous-routine Wstrcmp renvoie une valeur qui est:

• Inférieur à 0 si XString1 est inférieur à XString2
• égal à 0 si XString1 est égal à XString2
• Supérieur à 0 si XString1 est supérieur à XString2

La sous-routine Wstrncmp fait la même comparaison que Wstrcmp, mais elle compare, au plus, la valeur du paramètre Numéro de paires de caractères Wchar . Les comparaisons sont basées sur les valeurs de classement définies par la catégorie d'environnement local LC_COLLATE et la variable LANG .

La sous-routine Wstrcpy copie la chaîne pointé par le paramètre XString2 vers le tableau désigné par le paramètre XString1 . La copie s'arrête lorsque la valeur null Wchar_t est copiée. La sous-routine Wstrcpy renvoie la valeur du paramètre XString1 .

La sous-routine Wstrncpy copie la valeur du paramètre Numéro des caractères Wchar_t à partir de la chaîne pointé par le paramètre XString2 vers le tableau Wchar_T désigné par le paramètre XString1 . Si XString2 est inférieur à Numéro Wchar_t caractères, Wstrncpy extrait XString1 avec des caractères nuls de fin pour remplir les caractères Numéro Wchar_t . Si XString2 est Numéro ou plus de Wchar_t caractères, seuls les premiers caractères Numéro Wchar_t sont copiés ; le résultat n'est pas arrêté avec un caractère nul. La sous-routine Wstrncpy renvoie la valeur du paramètre XString1 .

La sous-routine Wstrlen renvoie le nombre de caractères Wchar_t dans la chaîne pointé par le paramètre Chaîne XString , sans inclure la valeur null Wchar_t de fin.

La sous-routine Wstrchr renvoie un pointeur vers la première occurrence de Wchar_t spécifiée par le paramètre Numéro dans la chaîne Wchar_t désignée par le paramètre Chaîne XString . Un pointeur null est renvoyé si Wchar_t ne se trouve pas dans la chaîne Wchar_t . La valeur null Wchar_t qui met fin à une chaîne est considérée comme faisant partie de la chaîne Wchar_t .

La sous-routine Wstrrchr renvoie un pointeur vers la dernière occurrence du caractère spécifié par le paramètre Numéro dans la chaîne Wchar_t pointé par le paramètre Chaîne XString . Un pointeur null est renvoyé si Wchar_t ne se trouve pas dans la chaîne Wchar_t . La valeur null Wchar_t qui met fin à une chaîne est considérée comme faisant partie de la chaîne Wchar_t .

La sous-routine Wstrpbrk renvoie un pointeur vers la première occurrence de la chaîne Wchar_t pointé par le paramètre XString1 de tout point de code à partir de la chaîne pointé par le paramètre XString2 . Un pointeur null est renvoyé si aucun caractère ne correspond.

La sous-routine Wstrspn renvoie la longueur du segment initial de la chaîne pointé par le paramètre XString1 qui se compose uniquement de points de code de la chaîne Wchar_t pointé par le paramètre XString2 .

La sous-routine Wstrcspn renvoie la longueur du segment initial de la chaîne Wchar_t pointé par le paramètre XString1 qui se compose entièrement de points de code Pas de la chaîne Wchar_t vers laquelle pointe le paramètre XString2 .

La sous-routine Wstrtok renvoie un pointeur vers une occurrence d'un jeton de texte dans la chaîne pointé par le paramètre XString1 . Le paramètre XString2 spécifie un ensemble de points de code comme délimiteurs de jeton. Si le paramètre XString1 est autre que null, la sous-routine Wstrtok lit la chaîne désignée par le paramètre XString1 jusqu'à ce qu'elle trouve l'un des points de code délimiteurs spécifiés par le paramètre XString2 . Il stocke ensuite une valeur null Wchar_t dans la chaîne Wchar_t , en remplaçant le point de code du délimiteur, et renvoie un pointeur à la première Wchar_t du jeton de texte. La sous-routine Wstrtok assure le suivi de sa position dans la chaîne Wchar_t de sorte que les appels suivants avec une étape de paramètre XString1 null via la chaîne Wchar_t . Les délimiteurs spécifiés par le paramètre XString2 peuvent être modifiés pour les appels suivants à Wstrtok. Lorsqu'aucun jeton ne reste dans la chaîne Wchar_t pointé par le paramètre XString1 , la sous-routine Wstrtok renvoie un pointeur null.

La sous-routine Wstrdup renvoie un pointeur vers une chaîne Wchar_t qui est un double de la chaîne Wchar_t à laquelle les points de paramètre XString1 . L'espace de la nouvelle chaîne est alloué à l'aide de la sous-routine Malloc . Lorsqu'une nouvelle chaîne ne peut pas être créée, un pointeur null est renvoyé.