5.1.8. Библиотеки стандартных функций

В данном разделе представлены не все стандартные функции. Полный список основных функций можно найти в любом справочнике по С++.

Функции ввода-вывода языка С++:

Функция clearerr

#include <cstdio.h>

void clearerr (file *stream);

Функция clearerr () сбрасывает флаг ошибки, связанный с потоком, на который ссылается указатель stream, а также обнуляет индикатор конца файла.

Функция fclose

#include <cstdio.h>

int fclose (file *stream);

Функция fclose () закрывает файл, связанный с указателем stream, и очищает буфер. После выполнения функции fclose () указатель stream больше не связан с файлом, и любой автоматически размещенный в памяти буфер удаляется из нее.

Функция feof

#include <cstdio.h>

int feof (file *stream);

Функция feof () проверяет позицию файлового курсора, чтобы распознать конец файла, связанного с указателем stream. Если курсор находится в конце файла, возвращается ненулевое значение, в противном случае возвращается нуль.

Функция ferror

#include <cstdio.h>

int ferror (file *stream);

Функция ferror() анализирует ошибку, связанную с файлом, на который ссылается указатель stream. Если никаких ошибок не обнаружено, возвращается нуль, в противном случае возвращается ненулевое значение.

Функция fflush

#include <cstdio.h>

int fflush (file *stream);

Если указатель stream связан с файлом, открытым для записи, вызов функции fflush () принудительно записывает содержание буфера в файл, который остается открытым.

Функция fgetc

#include <cstdio.h>

int fgetc (file *stream);

Функция fgetc () извлекает из входного потока stream следующий символ и увеличивает файловый курсор на единицу. Символ считывается, как значение типа unsigned char, и преобразуется в целое число.

Функция fgetpos

#include <cstdio.h>

int fgetpos (file *stream, fops_t *position);

Функция fgetpos () сохраняет в объекте, на который ссылается указатель position, текущее значение файлового курсора. Объект, на который ссылается указатель position, должен иметь тип fops_t. Сохраняемое значение оказывается полезным, лишь если в дальнейшем вызывается функция fsetpos ().

Функция fopen

#include <cstdio.h>

file *fopen (const char *fname, const char *mode);

Функция fopen () открывает файл, имя которого задается параметром fname, и возвращает указатель на поток, связанный с этим файлом.

Функция fwrite

#include <cstdio.h>

size_t fwrite (const void *buf, size_t size, size_t count, file *stream);

Функция fwrite () записывает в поток stream массив, состоящий из count

Функция fprintf

#include <cstdio.h>

int fprintf (file *stream, const char *format,…);

Функция fprintf () выводит в поток, связанный с указателем stream, значения своих аргументов в соответствии со строкой format. Функция возвращает количество реально выделенных символов. При возникновении ошибки возвращается отрицательное число.

Функция freopen

#include <cstdio.h>

file *freopen (const char *fname, const char *mode, file *stream);

Функция freopen () связывает существующий поток с другим файлом. Имя нового файла задается параметром fname, режим доступа – mode, а перенаправляемый поток – указателем stream. Параметр mode принимает те же значения, что и функции fopen ().

Функция fprint

#include <cstdio.h>

int fprint (const char *format,…);

Функция fprint () записывает в поток stdout свои аргументы в соответствии с форматной строкой format.

Функция remove

#include <cstdio.h>

int remove (const char *fname);

Функция remove () стирает файл, заданный параметром fname. Если файл успешно удален, функция возвращает нуль, в противном случае возвращает ненулевое значение. Зависимая функция: rename ().

Функция rename

#include <cstdio.h>

int rename (const char *oldname, const char *newname);

Функция rename () меняет имя файла, заданного указателем oldname, на имя, заданное параметром newname. Указатель newname не должен ссылаться ни на один из существующих файлов в текущем каталоге.

Математические функции, входящие в состав стандартной библиотеки, разделяются на следующие категории:

- тригонометрические;

- гиперболические;

- экспоненциальные и логарифмические;

- другие.

Для всех математических функций необходим заголовок <cmath>. (В программах на языке С используется заголовочный файл math.h).

Функция acos

#include <cmath>

float acos (float arg);

double acos (double arg);

long double acos (long double arg);

Функция acos () возвращает арккосинус аргумента arg. Значение аргумента функции acos () должно лежать в интервале от -1 до 1, иначе произойдет ошибка.

Функция asin

#include <cmath>

float asin (float arg);

double asin (double arg);

long double asin (long double arg);

Функция asin () возвращает арксинус аргумента arg. Значение аргумента функции asin () должно лежать в интервале от -1 до 1, иначе произойдет ошибка.

Функция atan

#include <cmath>

float atan (float arg);

double atan (double arg);

long double atan (long double arg);

Функция atan () возвращает арктангенс аргумента arg.

Функция cos

#include <cmath>

float cos (float arg);

double cos (double arg);

long double cos (long double arg);

Функция cos () возвращает косинус аргумента arg. Значение аргумента должно быть выражено в радианах.

Функция exp

#include <cmath>

float exp (float arg);

double exp (double arg);

long double exp (long double arg);

Функция exp () возвращает основание натурального логарифма е, возведенное в степень arg.

Функция fmod

#include <cmath>

float fmod (float x, float y);

double fmod (double x, double y);

long double fmod (long double x, long double y);

Функция fmod () возвращает остаток от деления x/y.

Функция log

#include <cmath>

float log (float num);

double log (double num);

long double log (long double num);

Функция log () возвращает натуральный логарифм числа num.

Функция sin

#include <cmath>

float sin (float arg);

double sin (double arg);

long double sin (long double arg);

Функция sin () возвращает синус аргумента arg. Значение аргумента должно быть выражено в радианах.

Функция tan

#include <cmath>

float tan (float arg);

double tan (double arg);

long double tan (long double arg);

Функция tan () возвращает тангенс аргумента arg. Значение аргумента должно быть выражено в радианах.

Функция sqrt

#include <cmath>

float sqrt (float num);

double sqrt (double num);

long double sqrt (long double num);

Функция sqrt () возвращает квадратный корень num. Если значение аргумента num отрицательно, возникает ошибка, связанная с выходом из области определения функции.

В стандартной библиотеке содержатся несколько функций, предназначенных для работы со временем и датой.

Функция asctime

#include <ctime>

char *asctime (const struct tm *ptr);

Функция asctime () возвращает указатель на строку, содержащую информацию, хранящуюся в структуре, на которую ссылается указатель ptr. Строка преобразуется следующим образом.

День месяц дата часы: минуты: секунды год \n \0.

Функция clock

#include <ctime>

clock_t clock (void);

Функция clock () возвращает приблизительное время работы вызывающей программы.

Функция ctime

#include <ctime>

char *ctime (const time_t *time);

Получив указатель на строку, содержащую календарное время, функция ctime () возвращает указатель на строку, имеющую следующий вид.

День месяц дата часы: минуты: секунды год \n \0.

Функция time

#include <ctime>

time_t time (time_t * time);

Функция time () возвращает текущее календарное время, установленное системой. Если системное время не установлено, функция возвращает число -1.

В стандартной библиотеке определен ряд служебных функций. К ним относятся функции, выполняющие преобразования, обработку списков аргументов, сортировку и поиск, а также генерирующие случайные числа. Многие из этих функций объявлены в заголовке <cstdlib>. (В программах на языке С ему соответствует заголовочный файл stdlib.h).

Функция abort

#include <cstdlib>

void abort (void);

Функция abort () приводит к аварийному завершению.

Функция rand

#include <cstdlib>

int rand (void);

Функция rand () генерирует последовательность псевдослучайных чисел. Каждый раз при вызове функции rand () возвращается целое число из диапазона от нуля до RAND_MAX.

Функция system

#include <cstdlib>

int system (const char *str);

Функция system () передает центральному процессору операционной системы команду, представленную в виде строки str.

Функция exit () не относится к управляющим операторам. Вызов стандартной библиотечной функции exit () приводит к прекращению работы программы и передаче управления операционной системе.

Функция exit () выглядит следующим образом.

void exit (int код_возврата);

Значение переменной код_возврата передается вызывающему процессу, в роли которого чаще всего выступает операционная система.