gets, _getws
Obtém uma linha do fluxo stdin. Versões mais seguras dessas funções estão disponíveis; confira gets_s, _getws_s.
Importante
Essas funções estão obsoletas. A partir do Visual Studio 2015, elas não estão disponíveis no CRT. As versões seguras dessas funções, gets_s e _getws_s, ainda estão disponíveis. Para obter informações sobre essas funções alternativas, confira gets_s, _getws_s.
Importante
Esta API não pode ser usada em aplicativos executados no Windows Runtime. Para obter mais informações, confira Funções do CRT sem suporte em aplicativos da Plataforma Universal do Windows.
Sintaxe
char *gets(
char *buffer
);
wchar_t *_getws(
wchar_t *buffer
);
template <size_t size>
char *gets(
char (&buffer)[size]
); // C++ only
template <size_t size>
wchar_t *_getws(
wchar_t (&buffer)[size]
); // C++ only
Parâmetros
buffer
Local de armazenamento para a cadeia de caracteres de entrada.
Valor retornado
Retorna o argumento se for bem-sucedido. Um ponteiro NULL indica uma condição de erro ou de final do arquivo. Use ferror oufeof para determinar qual das condições ocorreu. Se buffer for NULL, essas funções invocam um manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro. Se a execução puder continuar, essas funções retornarão NULL e definirão errno para EINVAL.
Comentários
A função gets lê uma linha do fluxo de entrada padrão stdin e a armazena em buffer. A linha consiste em todos os caracteres até e incluindo o primeiro caractere de nova linha ('\n'). gets, então, substitui o caractere de nova linha por um caractere nulo ('\0') antes de retornar a linha. Por sua vez, a função fgets retém o caractere de nova linha. _getws é uma versão de caractere largo de gets; seu argumento e o valor retornado são cadeias de caracteres largos.
Importante
Como não há uma forma de limitar o número de caracteres lidos por gets, entradas não confiáveis podem facilmente causar saturações de buffer. Use o fgets em vez disso.
No C++, essas funções têm sobrecargas de modelo que invocam os equivalentes mais novos e seguros dessas funções. Para obter mais informações, consulte Sobrecargas de modelo seguras.
Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.
Mapeamentos de rotina de texto genérico
| Rotina TCHAR.H | _UNICODE e _MBCS não definidos |
_MBCS definido |
_UNICODE definido |
|---|---|---|---|
_getts |
gets |
gets |
_getws |
Requisitos
| Rotina | Cabeçalho necessário |
|---|---|
gets |
<stdio.h> |
_getws |
<stdio.h> ou <wchar.h> |
Para obter informações sobre compatibilidade, consulte Compatibilidade.
Exemplo
// crt_gets.c
// compile with: /WX /W3
#include <stdio.h>
int main( void )
{
char line[21]; // room for 20 chars + '\0'
gets( line ); // C4996
// Danger: No way to limit input to 20 chars.
// Consider using gets_s instead.
printf( "The line entered was: %s\n", line );
}
A entrada com mais de 20 caracteres ultrapassará o buffer de linha e quase certamente fará com que o programa trave.
Hello there!The line entered was: Hello there!