Проекты с использованием контроллера Arduino

Часть III. Практическое применение Arduino 
Пример использования функции 
available()
представлен в листинге 15.1. 
Листинг 15.1 
// открыть файл для чтения 
myFile = SD.open("test.txt",); 
if (myFile) 
{ 
// чтение из файла и отправка 
// в последовательный порт 
while (myFile.available()) 
{ 
Serial.write(myFile.read()); 
} 
} 
// закрыть файл 
myFile.close(); 
Функция close() 
Функция 
close()
закрывает файл и сохраняет записанные на него данные на карту SD. 
Синтаксис: 
myFile.close() 
Параметр:
File
— экземпляр файла 
File
, возвращаемый 
SD.open()
. 
Возвращаемого значения нет. 
Функция flush() 
Функция 
flush()
гарантирует, что любые байты, записанные в файл, физически 
сохранятся на SD-карте (при закрытии файла это делается автоматически). 
Синтаксис: 
myFile.flush() 
Параметр: 
File
— экземпляр файла 
File
, возвращаемый 
SD.open()
. 
Возвращаемого значения нет. 
Функция peek() 
Функция 
peek()
считывает байт из файла из текущей позиции, не продвигаясь к 
следующей позиции. 
Синтаксис: 
myFile.peek() 
Параметр: 
File
— экземпляр файла 
File
, возвращаемый 
SD.open()
. 
Возвращаемые значения: байт из файла или –1, если байт не считан. 

---

Глава 15. Arduino и карта памяти SD 
205 
Функция position() 
Функция 
position()
возвращает текущую позицию в файле, куда следующий байт 
будет записываться или откуда считываться. 
Синтаксис: 
myFile.position() 
Параметр: 
File
— экземпляр файла 
File
, возвращаемый 
SD.open()
. 
Возвращаемое значение: текущая позиция в файле. 
Функция print() 
Функция 
print() 
записывает данные в файл, который был открыт для записи. 
Синтаксис: 
myFile.print(data) 
myFile.print(data, BASE) 
Параметры: 
 
File
— экземпляр файла 
File
, возвращаемый 
SD.open()
; 
 
data
— данные для записи в файл; 
 
BASE
— вид передаваемых символов: 
• 
BIN
— двоичный; 
• 
DEC
— десятичный; 
• 
OCT
— восьмеричный; 
• 
HEX
— шестнадцатеричный. 
Возвращаемого значения нет. 
Функция println() 
Функция 
println() 
записывает данные в файл, который был открыт для записи, 
данные дополняются символами перевода строки. 
Синтаксис: 
myFile.println() 
myFile.println(data) 
myFile.println(data, BASE) 
Параметры: 
 
File
— экземпляр файла 
File
, возвращаемый 
SD.open()
; 
 
data
— данные для записи в файл; 
 
BASE
— вид передаваемых символов: 
• 
BIN
— двоичный; 
• 
DEC
— десятичный; 

---

206