Директива library
Директива library объявляет библиотеку и задает
ее имя. Имя библиотеки используется в директиве
part of, чтобы указать, к какой библиотеке
относится присоединяемая часть. После имени библиотеки
можно указать строковый литерал с документацией,
которая будет отображаться в сгенерированной
документации для всей библиотеки. Директива
library необязательна: если она не указана,
библиотека все равно создается, но остается без имени.
Синтаксически после ключевого слова library
идет идентификатор - имя библиотеки, затем
необязательный строковый литерал с описанием.
Завершается директива точкой с запятой.
Синтаксис
library library_name;
library library_name;
/// Documentation comment.
library library_name;
Пример
Объявим библиотеку с именем my_library
и строковым описанием:
library my_library;
void main()
{
print('library my_library');
}
Результат выполнения кода:
"library my_library"
Пример
Объявим библиотеку с именем и строкой документации, а затем используем ее содержимое:
/// Utility functions for working with strings.
library string_utils;
String reverse(String str)
{
return str.split('').reversed.join();
}
void main()
{
print(reverse('abcde'));
}
Результат выполнения кода:
"edcba"
Пример
Имя библиотеки можно использовать в директиве
part of, чтобы присоединить часть к библиотеке:
library my_library;
part 'part_file.dart';
void main()
{
print(partFunction());
}
В файле part_file.dart указывается:
part of my_library;
String partFunction()
{
return 'hello from part';
}
Результат выполнения кода:
"hello from part"
