TaushkanovKV в 06:35, 27 апреля 2026

2026-04-27T06:35:00Z

TaushkanovKV в 06:29, 27 апреля 2026

2026-04-27T06:29:43Z

TaushkanovKV: Новая страница: «Класс предоставляет интерфейс для работы с файлами: открытие, закрытие, чтение и запись...»

2026-04-27T06:29:01Z

Новая страница: «Класс предоставляет интерфейс для работы с файлами: открытие, закрытие, чтение и запись...»

Новая страница

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

== Свойства ==
'''bool mostSignificantByteFirst'''
'''Назначение:''' Определяет порядок байтов (endianness) при чтении и записи числовых значений.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:''' Отсутствует (свойство).

'''Примечания:'''

* <code>true</code> – используется порядок '''Big-endian''' (старший байт первый).
* <code>false</code> (по умолчанию) – используется порядок '''Little-endian''' (младший байт первый).
* Влияет на методы <code>readInt</code>, <code>readUInt</code>, <code>readFloat</code>, <code>readDouble</code> и соответствующие методы записи.
* Может изменяться в любой момент до выполнения операций чтения/записи.

== Методы ==
'''int open(const string &in filename, const string &in mode)'''
'''Назначение:''' Открывает файл для чтения и/или записи.

'''Аргументы:'''

* <code>filename</code> – путь к файлу (относительный или абсолютный).
* <code>mode</code> – режим открытия файла:
** <code>"r"</code> – открыть для чтения (только чтение).
** <code>"w"</code> – открыть для записи (создаёт новый или перезаписывает существующий).
** <code>"a"</code> – открыть для добавления (запись в конец файла).

'''Возвращаемое значение:'''

* <code>0</code> – файл успешно открыт.
* <code>-1</code> – ошибка открытия (файл не существует, недостаточно прав, неверный режим).

'''Примечания:'''

* Перед открытием нового файла автоматически закрывает ранее открытый.
* На Windows автоматически добавляет флаг <code>"b"</code> (бинарный режим) для предотвращения преобразования <code>\r\n</code> в <code>\n</code>.
* На Windows CE пути преобразуются в абсолютные относительно директории приложения.
* Если режим не поддерживается (например, запись при <code>AS_WRITE_OPS == 0</code>), возвращает <code>-1</code>.

'''int close()'''
'''Назначение:''' Закрывает открытый файл.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* <code>0</code> – файл успешно закрыт.
* <code>-1</code> – файл уже был закрыт или не открыт.

'''Примечания:'''

* Автоматически вызывается в деструкторе объекта.
* После закрытия файла дальнейшие операции чтения/записи будут возвращать ошибки.

'''int getSize() const'''
'''Назначение:''' Возвращает размер файла в байтах.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Размер файла в байтах (тип <code>int</code>).
* <code>-1</code> – файл не открыт или произошла ошибка.

'''Примечания:'''

* Для определения размера сохраняет текущую позицию, перемещается в конец файла и возвращается обратно.

'''bool isEndOfFile() const'''
'''Назначение:''' Проверяет, достигнут ли конец файла.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* <code>true</code> – достигнут конец файла или файл не открыт.
* <code>false</code> – не достигнут конец файла.

'''Примечания:'''

* Использует стандартную функцию <code>feof()</code>.
* Возвращает <code>true</code>, если файл не открыт.

'''int getPos() const'''
'''Назначение:''' Возвращает текущую позицию в файле.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Текущая позиция в байтах от начала файла.
* <code>-1</code> – файл не открыт или произошла ошибка.

'''Примечания:'''

* Использует функцию <code>ftell()</code>.

'''int setPos(int pos)'''
'''Назначение:''' Устанавливает текущую позицию в файле от начала.

'''Аргументы:'''

* <code>pos</code> – абсолютная позиция в байтах от начала файла.

'''Возвращаемое значение:'''

* <code>0</code> – позиция успешно установлена.
* <code>-1</code> – файл не открыт или позиция вне допустимого диапазона.

'''Примечания:'''

* Использует функцию <code>fseek(SEEK_SET)</code>.

'''int movePos(int delta)'''
'''Назначение:''' Смещает текущую позицию в файле относительно текущего положения.

'''Аргументы:'''

* <code>delta</code> – смещение в байтах (положительное – вперёд, отрицательное – назад).

'''Возвращаемое значение:'''

* <code>0</code> – позиция успешно изменена.
* <code>-1</code> – файл не открыт или смещение выходит за границы.

'''Примечания:'''

* Использует функцию <code>fseek(SEEK_CUR)</code>.

'''string readString(uint length)'''
'''Назначение:''' Читает указанное количество символов из файла.

'''Аргументы:'''

* <code>length</code> – количество символов (байт) для чтения.

'''Возвращаемое значение:'''

* Строка с прочитанными данными (реальная длина может быть меньше <code>length</code>, если достигнут конец файла).
* Пустая строка – если файл не открыт.

'''Примечания:'''

* Возвращает все прочитанные байты как есть (включая нулевые символы).
* Размер результирующей строки соответствует количеству реально прочитанных байт.

'''string readLine()'''
'''Назначение:''' Читает одну строку из файла.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Строка, содержащая прочитанную строку (без символа <code>\n</code>).
* Пустая строка – если достигнут конец файла или файл не открыт.

'''Примечания:'''

* Читает до символа перевода строки (<code>\n</code>) или до заполнения внутреннего буфера (255 символов).
* Поддерживает чтение длинных строк – операция повторяется до обнаружения <code>\n</code> или конца файла.
* Символ <code>\n</code> не включается в результат.

'''int64 readInt(uint bytes)'''
'''Назначение:''' Читает знаковое целое число из файла.

'''Аргументы:'''

* <code>bytes</code> – количество байт для чтения (1–8). Если <code>bytes > 8</code>, используется 8.

'''Возвращаемое значение:'''

* Прочитанное целое число (тип <code>int64</code>).
* <code>0</code> – если файл не открыт или достигнут конец файла.

'''Примечания:'''

* Поддерживает автоматическое расширение знака (sign extension) для отрицательных чисел.
* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.
* Младшие байты заполняются нулями, если <code>bytes < 8</code>.
* Для отрицательных чисел старшие байты заполняются <code>0xFF</code>.

'''uint64 readUInt(uint bytes)'''
'''Назначение:''' Читает беззнаковое целое число из файла.

'''Аргументы:'''

* <code>bytes</code> – количество байт для чтения (1–8). Если <code>bytes > 8</code>, используется 8.

'''Возвращаемое значение:'''

* Прочитанное беззнаковое целое число (тип <code>uint64</code>).
* <code>0</code> – если файл не открыт или достигнут конец файла.

'''Примечания:'''

* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.
* Не выполняет расширение знака.
* Младшие байты заполняются нулями, если <code>bytes < 8</code>.

'''float readFloat()'''
'''Назначение:''' Читает число с плавающей точкой (32 бита) из файла.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Прочитанное число типа <code>float</code>.
* <code>0.0f</code> – если файл не открыт или достигнут конец файла.

'''Примечания:'''

* Читает ровно 4 байта.
* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.
* Использует объединение (union) для битового преобразования.

'''double readDouble()'''
'''Назначение:''' Читает число с плавающей точкой двойной точности (64 бита) из файла.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''

* Прочитанное число типа <code>double</code>.
* <code>0.0</code> – если файл не открыт или достигнут конец файла.

'''Примечания:'''

* Читает ровно 8 байт.
* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.
* Использует объединение (union) для битового преобразования.

== Методы записи ==
'''int writeString(const string &in str)'''
'''Назначение:''' Записывает строку в файл.

'''Аргументы:'''

* <code>str</code> – строка для записи.

'''Возвращаемое значение:'''

* Количество записанных байт.
* <code>-1</code> – если файл не открыт.

'''Примечания:'''

* Записывает строку целиком, включая все символы (без завершающего нуля).

'''int writeInt(int64 val, uint bytes)'''
'''Назначение:''' Записывает знаковое целое число в файл.

'''Аргументы:'''

* <code>val</code> – значение для записи.
* <code>bytes</code> – количество байт для записи (1–8). Если <code>bytes > 8</code>, используется 8.

'''Возвращаемое значение:'''

* Количество записанных байт (0 или 1 в терминах <code>fwrite</code>).
* <code>0</code> – если файл не открыт.

'''Примечания:'''

* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.
* Записываются только младшие <code>bytes</code> байт числа.

'''int writeUInt(uint64 val, uint bytes)'''
'''Назначение:''' Записывает беззнаковое целое число в файл.

'''Аргументы:'''

* <code>val</code> – значение для записи.
* <code>bytes</code> – количество байт для записи (1–8). Если <code>bytes > 8</code>, используется 8.

'''Возвращаемое значение:'''

* Количество записанных байт (0 или 1 в терминах <code>fwrite</code>).
* <code>0</code> – если файл не открыт.

'''Примечания:'''

* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.
* Записываются только младшие <code>bytes</code> байт числа.

'''int writeFloat(float val)'''
'''Назначение:''' Записывает число с плавающей точкой (32 бита) в файл.

'''Аргументы:'''

* <code>val</code> – значение для записи.

'''Возвращаемое значение:'''

* Количество записанных байт (0 или 1 в терминах <code>fwrite</code>).
* <code>0</code> – если файл не открыт.

'''Примечания:'''

* Записывает ровно 4 байта.
* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.

'''int writeDouble(double val)'''
'''Назначение:''' Записывает число с плавающей точкой двойной точности (64 бита) в файл.

'''Аргументы:'''

* <code>val</code> – значение для записи.

'''Возвращаемое значение:'''

* Количество записанных байт (0 или 1 в терминах <code>fwrite</code>).
* <code>0</code> – если файл не открыт.

'''Примечания:'''

* Записывает ровно 8 байт.
* Порядок байт определяется свойством <code>mostSignificantByteFirst</code>.

== Пример использования ==
// Создание и открытие файла для записи
file f;
f.mostSignificantByteFirst = false; // Little-endian

int result = f.open("data.bin", "w");

if (result == 0)
{
f.writeString("Hello, World!");
f.writeInt(12345, 4);
f.writeFloat(3.14159f);
f.close();
}

// Открытие файла для чтения
file f2;
f2.mostSignificantByteFirst = false;
f2.open("data.bin", "r");

if (!f2.isEndOfFile())
{
string str = f2.readLine();
int64 num = f2.readInt(4);
float pi = f2.readFloat();
}

f2.close();

// Чтение бинарных данных с Big-endian порядком
file f3;
f3.mostSignificantByteFirst = true; // Network byte order
f3.open("network_data.bin", "r");
uint64 value = f3.readUInt(4); // Читает 4 байта как Big-endian

← Предыдущая		Версия 06:35, 27 апреля 2026
Строка 1:		Строка 1:
	Класс предоставляет интерфейс для работы с файлами: открытие, закрытие, чтение и запись данных различных типов, позиционирование внутри файла. Поддерживает как текстовый, так и бинарный режимы работы.		Класс предоставляет интерфейс для работы с файлами: открытие, закрытие, чтение и запись данных различных типов, позиционирование внутри файла. Поддерживает как текстовый, так и бинарный режимы работы.
		+
		+	Класс доступен начиная с версии <code>AS 1.4.5</code>.

	== Свойства ==		== Свойства ==

← Предыдущая		Версия 06:29, 27 апреля 2026
Строка 353:		Строка 353:
	f3.open("network_data.bin", "r");		f3.open("network_data.bin", "r");
	uint64 value = f3.readUInt(4); // Читает 4 байта как Big-endian		uint64 value = f3.readUInt(4); // Читает 4 байта как Big-endian
		+
		+	[[Категория:AgavaSCADA/AgavaPLC]]

Класс file - История изменений

TaushkanovKV в 06:35, 27 апреля 2026

TaushkanovKV в 06:29, 27 апреля 2026

TaushkanovKV: Новая страница: «Класс предоставляет интерфейс для работы с файлами: открытие, закрытие, чтение и запись...»