Описание

Метод append добавляет указанный сегмент файлового пути String finalSegment к концу данного и возвращает получившийся суммарный путь. В процессе объединения сегментов пути, при необходимости, между ними автоматически добавляется разделитель каталогов. Получившийся путь не канонизируется.

Кроме этого, добавляемый сегмент String finalSegment может сосотоять из нескольких отрезков пути, т.е. содержать в себе разделители пути.

Исходный путь при всем при этом, остается неизменным.

Заметки

Примеры использования:

import "dart:io";

void main() {
  // объявим массив с данными
  List<String> years = ['2010','2011','2012'];

  // объявим и инициализируем базовый путь к хранилищу изображений
  Path basePath = new Path.fromNative("d:\\STORAGE\\IMAGES");

  // получим и выведем на экран список путей
  years.forEach((String year) {
    // для каждого элемента массива получим свой путь,
    // как вложенную в базовую дирекорию с номером года
    Path pathSubYear = basePath.append("$year\\");

    // выведем результат
    print(pathSubYear.toNativePath());
  });


  // можно так же воспользоваться более компактной записью
  ['2010','2011','2012'].forEach((String year) {
    print(basePath.append("$year\\").toNativePath());
  });

  // в обоих случаях результат будет одинаковый:
  // d:\STORAGE\IMAGES\2010\
  // d:\STORAGE\IMAGES\2011\
  // d:\STORAGE\IMAGES\2012\
}
						

Официальная документация (английский)