input.c

#include "math.h" //for NAN
#include "stdio.h" //for rewind
#include "stdlib.h" //for calloc
#include "assert.h"
/*!
 * \brief Заполняет массив чисел типа double каким-либо числом
 *
 * В данной версии программы не используется, но пусть будет на всякий случай
 *
 * \param [out] arr[] Массив, который нужно заполнить
 * \param [in] nElements Количество элементов в массиве. Можно заполнить не все элементы,
 * а только первые nElemets, считая от начала
 * \param [in] value Значение, которое присвоиться каждому элементу массива
 * с индексом от 0 до nElements - 1. В частности, можно присвоить нули или NAN.
 */
void fillDArray(double arr[], size_t nElements, double value)
{
	for(int i = 0; i < nElements; ++i)
		arr[i] = value;
}

/*!
 * \brief Выводит массив double-ов в стандартный вывод
 *
 * \param arr[] Массив, который нужно вывести
 * \param from Начиная с какого индекса выводит
 * \param to Заканчивая каким
 *
 * Пример использования:
 * \code
 * double values[] = {1, 2.5, 3};
 * printDArray(values, 0, 2);
 * \endcode
 */
void printDArray(const double arr[], size_t from, size_t to)
{
	for(int k = from; k <= to; ++k)
		printf("  (%4d) ", k);
	printf("\n");
	for(int k = from; k <= to; ++k)
		printf(" %7lg ", arr[k]); 
	printf("\n");
}

/*!
 * \brief Выводит массив int-ов в стандартный вывод
 *
 * \version 1.0
 *
 * В данной версии программы не используется, но пусть будет на всякий случай
 *
 * \param arr[] Массив, который нужно вывести
 * \param from Начиная с какого индекса выводит
 * \param to Заканчивая каким
 *
 * Пример использования:
 * \code
 * int values[] = {1, 7, 3, 8. 6};
 * printArray(values, 0, 4);
 * \endcode
 */
void printArray(const int arr[], size_t from, size_t to)
{
	for(int k = from; k <= to; ++k)
		printf("  (%4d) ", k);
	printf("\n");
	for(int k = from; k <= to; ++k)
		printf(" %7d ", arr[k]); 
	printf("\n");
}

/*!
 * \brief Считывает из стандартного ввода указанное число чисел в заданный массив
 *
 * \param prompt Строка, которая напечатается в консоли для приглашения пользователя ввести числа
 * \param mas Массив, в который нужно записать считанные числа
 * \param nElements Число чисел, которые нужно считать. Размер переданного массива должен быть
 * не меньше nElements
 *
 * Пример использования:
 * \code
 * const int nElements = 3;
 * double coeffs[nElements] = {};
 * input("Enter x, y, z:", coeffs, nElements);
 * 
 *	printDArray(coeffs, 0, nElements - 1);
 * \endcode
 */
void input(const char prompt[], double mas[], size_t nElements) //Version 1
{
	assert(prompt != NULL);
	assert(mas != NULL);

	printf("%s\n", prompt);
	for(int i = 0; i < nElements; ++i)
	{
		rewind(stdin); //clears stdin
		printf("[%d/%lu]: ", i + 1, nElements);
		if(scanf("%lg", mas + i) != 1 || getchar() != '\n') //incorrect input
		{
			printf("ERROR : Incorrect input! Try again!\n");
			--i;
			continue;
		}
	}
}

/*!
 * \brief Считывает из стандартного ввода указанное число чисел и возвращает массив
 *
 * В отличие от функции input(), массив создается динамически внутри самой функции, поэтому создавать
 * массив заранее и передавать его адрес в getNewData() не требуется
 * 
 * \warning Обязательно освобождайте память, выделенную под массив, после использования!
 *
 * \param prompt Строка, которая напечатается в консоли для приглашения пользователя ввести числа
 * \param mas Массив, в который нужно записать считанные числа
 * \param nElements Число чисел, которые нужно считать. Размер переданного массива должен быть
 * не меньше nElements
 *
 * Пример использования:
 * \code
 * const int nElements = 3;
 * double *coeffs = getNewData("Enter x, y, z:", nElements);
 * printDArray(coeffs, 0, nElements - 1);
 * 
 * free(coeffs);
 * coeffs = NULL;	
 * \endcode
 */
double *getNewData(const char prompt[], size_t nElements) //Version 2
{
	assert(prompt != NULL);
	double *data = calloc(nElements, sizeof(data[0]));
	if(data == NULL) //BAD_ALLOC
	{
		printf("ERROR: BAD_ALLOC\n");
		return NULL;
	}

	input(prompt, data, nElements);
	return data;
}