gets_s

De RAD Studio
Aller à : navigation, rechercher

Remonter à stdio.h - Index


Fichier en-tête

stdio.h

Catégorie

Fonctions d'entrée/sortie de caractères

Prototype

char *gets_s(char *s, rsize_t n);

Description

Remplace gets, getws en ajoutant des améliorations relatives à la sécurité.

gets_s collecte n nombre de caractères de stdin et les place dans s. Le nombre maximal de caractères que gets_s peut lire est n-1.

En cas de violation des contraintes d'exécution, s[0] est défini sur null, et un nombre indéterminé de caractères sont lus depuis stdin et ignorés, jusqu'à ce qu'un caractère nouvelle ligne, EOF ou une erreur de lecture soit rencontré.

Remarque : Pour les applications Win32 GUI, stdin doit être redirigé.

Remarque : fgets, fgetws permettent une gestion adéquate de la lecture des lignes d'entrée qui ne peuvent pas être stockées dans le tableau des résultats. Les utilisateurs finaux doivent penser à utiliser fgets, fgetws au lieu de gets_s.

Valeur renvoyée

En cas de succès, get_s renvoie l'argument chaîne s.

En cas d'erreur ou de fin de fichier, elle renvoie null.

Exemple

#include <stdio.h>
int main(void)
{
   char string[80];
   printf("Input a string:");
   gets_s(string,5);
   printf("The string input was: %s\n", string);
   return 0;
}

Portabilité

POSIX Win32 ANSI C ANSI C++

gets_s

+

+

+

+

Voir aussi