Processing:Справочник языка Processing/loadTable()

Содержание

Среда разработки Processing

Справочник языка Processing

Библиотеки

Примеры

Режимы программирования

Перевод: Максим Кузьмин

Проверка/Оформление/Редактирование: Мякишев Е.А.

loadTable()

Обозначение

loadTable()

Описание

Считывает содержимое файла или URL, а затем создает объект Table, который содержит данные из считанного файла. Если в параметре filename указано название файла, он должен находиться в папке «data» текущего скетча. Кроме того, в filename может быть URL – если вам нужно прочесть файл, находящийся в сети. Параметр filename должен заканчиваться расширением файла, но его также можно отдельно указать в параметре options. Если вы, к примеру, используете данные, разделенные табуляцией, и если в конце параметра filename (будь то название файла или URL) не указано расширение *.tsv, то в параметре options нужно указать tsv.

Примечание: Если расширение указано в обоих параметрах, метод воспользуется тем, то находится в параметре options.

Если в файле есть строка заголовка, впишите в параметр options слово header. Если в файле нет строки заголовка, слово header в параметре options можно не указывать.

Если вы указываете в loadTable() одновременно разрешение и слово header, то их нужно разделить запятой. Это может выглядеть примерно так: loadTable("data.csv", "header, tsv").

Все файлы, загружаемые и сохраняемые при помощи Processing API, используют кодировку UTF-8.

Синтаксис

loadTable(filename)
loadTable(filename, options)

Параметры

filename – название файла в папке «data» или URL. Тип данных – String
options – может содержать header, tsv, csv или bin, разделенные запятыми. Тип данных – String

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

Тип данных – объект Table

Пример

// В этом скетче выполняется разбор небольшого CSV-файла
// под названием "mammals.csv", который представлен ниже.
// Он должен находиться в папке «data» проекта.
//
// id,species,name
// 0,Capra hircus,Goat
// 1,Panthera pardus,Leopard
// 2,Equus zebra,Zebra

Table table;

void setup() {
  
  table = loadTable("mammals.csv", "header");

  println(table.getRowCount() + " total rows in table"); 

  for (TableRow row : table.rows()) {
    
    int id = row.getInt("id");
    String species = row.getString("species");
    String name = row.getString("name");
    
    println(name + " (" + species + ") has an ID of " + id);
  }
  
}

// скетч напечатает:
// 3 total rows in table
// Goat (Capra hircus) has an ID of 0
// Leopard (Panthera pardus) has an ID of 1
// Zebra (Equus zebra) has an ID of 2