Exporter (0) Imprimer
Développer tout
and
div
eof
not
or
xor
Développer Réduire
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

gets_s, _getws_s

Récupère une ligne du flux stdin. Ces versions de gets, _getws présentent des améliorations dans la sécurité, comme décrit dans Fonctionnalités de sécurité dans le CRT.

char *gets_s( 
   char *buffer,
   size_t sizeInCharacters
);
wchar_t *_getws_s( 
   wchar_t *buffer,
   size_t sizeInCharacters
);
template <size_t size>
char *gets_s( 
   char (&buffer)[size]
); // C++ only
template <size_t size>
wchar_t *_getws_s( 
   wchar_t (&buffer)[size]
); // C++ only

[out] buffer

Emplacement de stockage de la chaîne d'entrée.

[in] sizeInCharacters

Taille de la mémoire tampon.

En cas de réussite, retourne buffer. Un pointeur NULL indique une erreur ou une condition de fin de fichier. Utilisez ferror ou feof pour déterminer laquelle s'est produite.

La fonction gets_s lit une ligne du flux d'entrée standard stdin et la stocke dans buffer. La ligne se compose de tous les caractère jusqu'au premier caractère de saut de ligne ("\n ") inclus. gets_s remplace ensuite le caractère de saut de ligne par un caractère Null ("\0 ") avant de retourner la ligne. En revanche, la fonction fgets_s conserve le caractère de nouvelle ligne.

Si la première lecture de caractère est le caractère de fin de fichier, un caractère Null est enregistré au début du buffer et NULL est retourné.

_getws est une version caractères larges gets_s; son argument et la valeur de retour sont des chaînes de caractères larges.

Si buffer est NULL ou sizeInCharacters est inférieur ou égal à zéro, ou si la mémoire tampon est trop petite pour contenir la ligne d'entrée et le terminateur null, ces fonctions appellent un gestionnaire de paramètre non valide, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, ces fonctions retournent NULL et définissent erno à la valeur ERANGE.

En C++, l'utilisation de ces fonctions est simplifiée par les surcharges de modèle ; les surcharges peuvent déduire la longueur de la mémoire tampon automatiquement (ce qui évite d'avoir à spécifier un argument taille) et peuvent remplacer automatiquement les fonctions plus anciennes et non sécurisées par leurs équivalentes plus récentes et sécurisées. Pour plus d'informations, consultez Sécuriser les surcharges de modèle.

Mappages de routines de texte générique

Routine TCHAR.H

_UNICODE & _MBCS non définis

_MBCS défini

_UNICODE défini

_getts

gets_s

gets_s

_getws

Routine

En-tête requis

gets_s

<stdio.h>

_getws

<stdio.h> ou <wchar.h>

La console n'est pas prise en charge dans les applications Windows Store . Les handles de flux standard associés à la console, stdin, stdout et stderr doivent être redirigés pour que les fonctions runtime C puissent les utiliser dans les applications Windows Store . Pour plus d'informations sur la compatibilité, consultez Compatibilité.

// crt_gets_s.c
// This program retrieves a string from the stdin and 
// prints the same string to the console.

#include <stdio.h>

int main( void )
{
   char line[21]; // room for 20 chars + '\0'
   gets_s( line, 20 );
   printf( "The line entered was: %s\n", line );
}

  Bonjour à vous !la ligne entrée était : Bonjour à vous !

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft