Что возвращает функция scanf
в Visual Studio 2015 printf функция и scanf семейство функций были объявлены как inline и перемещены в заголовки и. При переносе старого кода вы можете увидеть ошибку LNK2019 в подключении к этим функциям. Дополнительные сведения см. в статье Visual C++ журнал изменений 2003-2015.
Синтаксис
Параметры
format
Строка управления форматированием.
argument
Необязательные аргументы.
locale
Используемый языковой стандарт.
Возвращаемое значение
Возвращает количество успешно преобразованных и назначенных полей. Возвращаемое значение не включает поля, которые были прочитаны, но не были назначены. Возвращаемое значение 0 указывает, что поля не были назначены.
Комментарии
wscanf — это версия scanf с расширенными символами; аргумент format для wscanf — строка расширенных символов. wscanf и scanf ведут себя одинаково, если поток открыт в режиме ANSI. scanf сейчас не поддерживает ввод из потока ЮНИКОДА.
Версии этих функций с суффиксом _l идентичны за исключением того, что они используют переданный параметр языкового стандарта вместо языкового стандарта текущего потока.
Универсальное текстовое сопоставление функций
TCHAR.H ассемблер | _UNICODE & _MBCS не определено | _MBCS определяется | _UNICODE определяется |
---|---|---|---|
_tscanf | scanf | scanf | wscanf |
_tscanf_l | _scanf_l | _scanf_l | _wscanf_l |
Требования
Функция scanf
Основное отличие функции scanf в том, что при считывании чисел (или значений типа char) ей необходимо передавать адреса переменных (в языке C все параметры передаются по значению, поэтому чтобы функция scanf могла модифицировать переменную, необходимо передать в функцию адрес этой переменной). Поэтому перед названиями переменных мы пишем знак амперсанда («&»).
В функции scanf могут быть явно записаны какие-то символы, кроме форматных строк. Например, вызов
Если в форматной строке встречается пробел, то он означает, что будет считано любое число пробельных символов, возможно даже нулевое.
Особенности считывания чисел
Функция scanf корректно считывает целые числа, если они начинаются с символа 0, или со знака «+». То есть числа «+123» или «0123» будут корректно считаны по форматной строке «%d», никаких дополнительных параметров задавать не нужно.
Также при считывании чисел игнорируются пробелы перед числом. Это означает, что вызов
Чтобы считать записать вида «01␣:␣23» можно использовать форматную строку «%d :%d», причем пробел в форматной строке может означать и отсутствие пробелов.
Возможные форматные символы
Форматная строка | Соответствующий ей тип |
%hhd | Считать число (десятичное) и записать его в переменную типа char (для unsigned char нужно использовать %hhu) |
%hd | short int (для unsigned short int нужно использовать %hu) |
%d | int (для unsigned int нужно использовать %u) |
%ld | long int (для unsigned long int нужно использовать %lu) |
%lld | long long int (для unsigned long long int нужно использовать %llu) |
%f | float |
%lf | double |
%Lf | long double |
%с | char. Считывается один символ, он может быть пробелом или символом конца строки. |
%s | Считывается последовательность непробельных символов (строка), записывается в C-строку (типа char * или char[]) |
Особенность считывание символов
Считывание одного символа «%c» считывает из потока ввода следующий символ, он может быть в том числе и пробельным символом, а также символом конца строки. Но если в форматной строке перед «%c» поставить пробел, то поскольку пробел в форматной строке обозначает последовательность пробельных символов любой длины, то в этом случае будет считан следующий непробельный символ.
Особенность считывания строк
При считывании строки результат записывается в С-строку, которая представляет собой массив символов (или указатель типа char * с выделенной памятью). Поскольку строка в языке C является адресом (указателем) в памяти, где хранится начало строки символов, то передавать в функцию scanf нужно имя переменной без указания амперсанда.
Функция scanf читает строку до первого пробельного символа, также она пропускает предшествующие пробелы, то есть она записывает следующее слово целиком составленное из непробельных символов.
Функция gets считается опасной и не рекомендуется для использования, так как она не контролирует количество считанных символов и не учитывает длину передаваемой строки, что может привести к записи данных за пределами строки.
В данном случае мы использовали stdin для чтения со стандартного ввода.
Возвращаемое значение
Функция scanf возвращает значение, равное числу успешно считанных и записанных в переданные параметры значений, что можно использовать для анализа входных данных.
Тогда при вводе строки «12:34» функция scanf считает два числа, запишет их в переменные a и b и вернет значение 2. А при вводе «12 34» будет считано только одно число, поскольку после него должно идти двоеточие, то второе число считано не будет и функция scanf вернет значение 1.
scanf()
Теперь поговорим о каждом из этих видов.
Спецификаторы преобразования
Код | Значение |
---|---|
%a | Читает значение с плавающей точкой (только С99) |
%c | Читает одиночный символ |
%d | Читает десятичное целое число |
%i | Читает целое число как в десятичном, так и восьмеричном или шестнадцатеричном формате |
%e | Читает число с плавающей точкой |
%f | Читает число с плавающей точкой |
%g | Читает число с плавающей точкой |
%о | Читает восьмеричное число |
%s | Читает строку |
%x | Читает шестнадцатеричное число |
%p | Читает указатель |
%n | Принимает целое значение, равное количеству уже считанных символов |
%u | Читает десятичное целое число без знака |
%[] | Читает набор сканируемых символов |
%% | Читает знак процента |
Ввод чисел
Функция scanf() прекращает чтение числа тогда, когда встречается первый нечисловой символ.
Ввод целых значений без знака
Чтение одиночных символов с помощью scanf()
При чтении одиночного символа символы разделителей читаются так же, как и любой другой символ, хотя при чтении данных других типов разделители интерпретируются как разделители полей. Например, при вводе с входного потока «x y» фрагмент кода
Чтение строк
Ввод адреса
Спецификатор %n
Спецификатор %n указывает, что scanf() должна поместить количество символов, считанных (до того момента, когда встретился %n ) из входного потока в целую переменную, указанную соответствующим аргументом.
Использование набора сканируемых символов
При использовании набора сканируемых символов функция scanf() продолжает читать символы, помещая их в соответствующий массив символов, пока не встретится символ, не входящий в этот набор. При возвращении из scanf() в массиве символов будет находиться строка, состоящая из считанных символов, причем эта строка будет заканчиваться символом конца строки. Чтобы увидеть, как это все работает, запустите следующую программу:
В большинстве реализаций для указания диапазона можно использовать дефис. Например, указанный ниже набор сканируемых символов дает функции scanf() указание принимать символы от А до Z:
Следует обратить внимание на такой важный момент: набор сканируемых символов чувствителен к регистру букв. Если нужно сканировать буквы и на верхнем, и на нижнем регистре, то их надо указывать отдельно для каждого регистра.
Пропуск лишних разделителей
Разделитель в управляющей строке дает scanf() указание пропустить в потоке ввода один или несколько начальных разделителей. Разделителями являются пробелы, табуляции, вертикальные табуляции, подачи страниц и разделители строк. В сущности, один разделитель в управляющей строке заставляет scanf() читать, но не сохранять любое количество (в том числе и нулевое) разделителей, которые находятся перед первым символом, не являющимся разделителем.
Символы в управляющей строке, не являющиеся разделителями
Функции scanf() необходимо передавать адреса
Строки будут читаться в символьные массивы, а имя массива без индекса является адресом первого его элемента. Таким образом, чтобы прочитать строку в символьный массив, можно использовать оператор
Модификаторы форматат
Если поток ввода содержит больше 20 символов, то при следующем вызове функций ввода считывание начнется после того места, где оно закончилось при предыдущем вызове. Например, если вы в ответ на вызов scanf() из этого примера введете
в str будут помешены буквы UVWXYZ. Ввод из поля может завершиться и до того, как будет достигнута максимальная длина поля — если встретится разделитель. В таком случае scanf() переходит к следующему полю.
На заметку | В С99 для функции scanf() имеются еще и другие модификаторы типа; о них рассказывается в части II. |
Подавление ввода
scanf
Функция scanf() является процедурой ввода общего назначения, считывающей данные из потока stdin. Она может считывать данные всех базовых типов и автоматически конвертировать их в нужный внутренний формат. Если бы printf() выполняла ввод, а не вывод, ее можно было бы назвать аналогом scanf().
Управляющая строка, на которую указывает format, состоит из символов трех типов:
Спецификаторы формата следуют за символом процент и сообщают scanf(), данные какого типа будут считаны следующими. Коды спецификаторов приведены в таблице.
Код | Значение |
---|---|
%с | Считать один символ |
%d | Считать десятичное число целого типа |
%i | Считать десятичное число целого типа |
%е | Считать число с плавающей запятой |
%f | Считать число с плавающей запятой |
%g | Считать число с плавающей запятой |
%о | Считать восьмеричное число |
%s | Считать строку |
%х | Считать шестнадцатиричное число |
%р | Считать указатель |
%n | Принимает целое значение, равное количеству считанных до текущего момента символов |
%u | Считывает беззнаковое целое |
%[] | Просматривает набор символов |
%% | Считывает символ % |
Например, %s считывает строку, a %d считывает переменную целого типа.
Строка формата считывается слева направо, при этом устанавливается соответствие между кодами формата и аргументами из списка аргументов.
Специальные символы в управляющей строке заставляют scanf() пропускать один или больше специальных символов во входном потоке. Специальные символы — это пробел, табуляция или новая строка. Один специальный символ в управляющей строке заставляет scanf() считывать, не запоминая, любое количество (включая нуль) идущих подряд специальных символов из входного потока, пока не встретится символ, не являющийся специальным символом.
Наличие обычного символа заставляет scanf() считать и отбросить соответствующий символ. Например, «%d,%d» заставляет scanf() считать целое число, считать и отбросить запятую и затем считать еще одно целое число. Если указанный символ не обнаружен во входном потоке, scanf() останавливается.
Все переменные, используемые для приема значений с помощью функции scanf(), должны отыскиваться по их адресам. Это значит, что все аргументы функции должны быть указателями на переменные. Таким образом, С создает возможность передачи по ссылке, и это позволяет функции изменять содержимое аргумента.
Например, чтобы считать целое число и присвоить его значение переменной count, необходимо воспользоваться следующим обращением к scanf():
Строки считываются в массивы символов, и имя массива, без всякого указателя, является адресом первого элемента массива. Поэтому, чтобы считать строку в массив символов address, можно использовать команду
В этом случае имя address уже является указателем и не нуждается в префиксе &.
Элементы вводимых данных должны разделяться пробелами, знаками табуляции или новой строки.
Знаки пунктуации, такие как запятая, точка с запятой и т.п., не считаются разделителями. Это значит, что для оператора
последовательность 10 20 будет воспринята, а последовательность 10,20 — нет. Спецификаторы формата scanf() расположены в том же порядке, что и переменные в списке аргументов, которым присваиваются значения принимаемых переменных.
Знак *, помещенный после % и перед спецификатором формата, считывает данные указанного типа, но подавляет их присваивание. Таким образом, код
при вводе последовательности 10/20 присваивает значение 10 переменной х, отбрасывает символ / и присваивает значение 20 переменной у.
Командами форматирования может задаваться модификатор максимальной ширины поля. Он представляет собой целое число, которое помещается между знаком % и спецификатором формата. Он ограничивает количество считываемых символов для любого поля. Например, если необходимо считать не больше, чем 20 символов в массив address, следует написать
Если входной поток содержал больше 20 символов, то при последующем вызове функция ввода начнет ввод с того места, где был остановлен ввод при текущем обращении. Ввод поля может быть прерван и до достижения максимальной длины поля, если встретится пробел. В этом случае scanf() переходит к следующему полю.
Хотя пробелы, символы табуляции и новых строк используются как разделители полей, они считываются как любой другой символ при вводе одиночного символа. Например, при входном потоке х у функция
поместит символ х в переменную а, пробел — в переменную b и y — в переменную c.
Надо быть внимательным: любые другие символы в управляющей строке — включая пробелы, символы табуляции и новых строк — используются для указания и отбрасывания символов из входного потока. Например, при входном потоке 10t20 функция
поместит 10 в х, а 20 в у. Символ t будет отброшен, поскольку в управляющей строке имеется t.
Еще одна возможность функции scanf() называется множеством сканирования. С помощью множества сканирования определяются символы, которые будут считываться функцией scanf() и присваиваться элементам соответствующего массива символов. Чтобы задать множество сканирования, надо символы, ввод которых допустим, поместить в квадратные скобки. Перед первой квадратной скобкой ставится знак процента. Например, следующий перечень множества сканирования задает считывание функцией scanf() только символов А, В и С:
Соответствующий перечню множества сканирования аргумент должен быть указателем на массив символов. При использовании множества сканирования функция scanf() считывает символы и помещает их в указанный массив до тех пор, пока не встретится символ, не входящий в множество сканирования (то есть считываются только символы, входящие в множество сканирования).
Массив, возвращенный scanf(), будет содержать строку с нулевым символом в конце. Перечень считываемых символов можно задать и в инверсной форме. Для этого в качестве первого символа надо поместить ^. Тогда scanf() будет принимать любой символ, не входящий в множество сканирования.
С помощью кавычек можно задать диапазон воспринимаемых символов. Например, следующее выражение дает указание scanf() принимать буквы от «А» до «Z»:
Множество сканирования различает прописные и строчные буквы. Если необходимо, чтобы scanf() принимала те и другие, необходимо перечислить их в множестве сканирования отдельно.
Функция scanf() возвращает число, равное количеству полей, значения которых были действительно присвоены переменным. В это количество не входят поля, которые были считаны, но их значения не были ничему присвоены вследствие использования модификатора * для подавления присваивания. Если до присвоения значения первого поля произошла ошибка, возвращается EOF.
При использовании Borland С++ в 16-разрядной среде можно изменить модель памяти, используемую по умолчанию для компилирования программы, путем явного указания размера каждого указателя, используемого при вызове scanf(). Ближний указатель задается модификатором N, а дальний — модификатором F. (Нельзя использовать модификатор N, если программа скомпилирована для модели памяти huge.)
Функция scanf
Функция scanf() представляет собой процедуру ввода общего назначения, которая читает поток stdin и сохраняет информацию в переменных, перечисленных в списке аргументов. Она может читать все встроенные типы данных и автоматически преобразовывать их в соответствующий внутренний формат.
Спецификации формата начинаются знаком % и сообщают функции scanf() тип данного, которое будет прочитано. Спецификации формата приведены в таблице 13.3. Например, по спецификации %s будет прочитана строка, а по спецификации %d — целое значение. Строка форматирования читается слева направо, и спецификации формата сопоставляются аргументам в порядке их перечисления в списке аргументов.
Код | Назначение |
---|---|
%a | Читает значение с плавающей точкой (только C99) |
%A | Аналогично коду %a (только C99) |
%c | Читает один символ |
%d | Читает десятичное целое |
%i | Читает целое в любом формате (десятичное, восьмеричное или шестнадцатеричное) |
%e | Читает число с плавающей точкой |
%E | Аналогично коду %e |
%f | Читает число с плавающей точкой |
%F | Аналогично коду %f (только С99) |
%g | Читает число с плавающей точкой |
%G | Аналогично коду %g |
%o | Читает восьмеричное число |
%s | Читает строку |
%x | Читает шестнадцатеричное число |
%X | Аналогично коду %x |
%p | Читает указатель |
%n | Принимает целое значение, равное количеству прочитанных до сих пор символов |
%u | Читает десятичное целое без знака |
%[] | Просматривает набор символов |
%% | Читает знак процента |
Современные компиляторы, поддерживающие добавленные в 1995 году средства работы с двухбайтовыми символами, позволяют к спецификации c применить модификатор l ; тогда будет считаться, что соответствующий указатель указывает на двухбайтовый символ (т.е. на данное типа whcar_t ). Модификатор l также можно использовать с кодом формата s ; тогда будет считаться, что соответствующий указатель указывает на строку двухбайтовых символов. Кроме того, модификатор l можно использовать для того, чтобы указать, что набор сканируемых символов состоит из двухбайтовых символов.
Если в строке форматирования встретится разделитель, то функция scanf() пропустит один или несколько разделителей во входном потоке. Под разделителем, или пробельным символом, подразумевается пробел, символ табуляции или разделитель строк (символ новой строки). По сути, наличие одного разделителя в управляющей строке приведет к тому, что функция scanf() будет читать, не сохраняя, любое количество (возможно, даже нулевое) разделителей до первого символа, отличного от разделителя.
Команды форматирования могут содержать модификатор максимальной длины поля. Он представляет собой целое число, располагаемое между знаком % и кодом формата, которое ограничивает количество читаемых для всех полей символов. Например, если в переменную address нужно прочитать не более 20 символов, используется следующий оператор.
При использовании набора сканируемых символов функция scanf() продолжает читать символы и помещать их в соответствующий массив символов до тех пор, пока не встретится символ, отсутствующий в заданном наборе. Соответствующая набору переменная должна быть указателем на массив символов. При возврате из функции scanf() этот массив будет содержать строку из прочитанных символов, завершающуюся символом конца строки.
Важно помнить, что в наборе сканируемых символов различаются прописные и строчные буквы. Следовательно, чтобы сканировать как прописные, так и строчные буквы, в наборе сканируемых символов придется задать их отдельно.
Модификаторы формата, добавленные к функции scanf() Стандартом C99
Пример
Действие данных операторов scanf() объясняется в комментариях.