[ -i[extension] ]

[ -e command ] [ - ] [ programfile ] [ argument ]...

For ease of access, the Perl manual has been split up into a number of sections:

Разделы руководства состоят из отдельных частей, которым присвоены имена, например: perlfunc (функции Perl), perlop (операторы Perl) или perlfaq (список часто задаваемых вопросов по Perl). Для доступа к странице руководства perlfunc введите команду perldoc perlfunc. Названия всех разделов руководства перечислены на странице руководства perldoc perl.

Чтобы найти в руководстве функцию по имени, нужно запустить утилиту perldoc с ключом -tf. В следующем примере показано, как найти в руководстве описание

функции print: $ perldoc -tf print

В FAQ собраны часто задаваемые вопросы, касающиеся Perl. Люди, изучающие Perl, задают одни и те же вопросы. Поэтому, чтобы сохранить время и избавить их от множества проблем, все эти вопросы собраны в файлы FAQ. Чтобы найти нужную тему в FAQ, воспользуйтесь ключом -q, после него укажите слово, которое может находиться в заголовке FaQ. К примеру, если вы хотите узнать о поддержке Perl, введите следующую команду:

$ perldoc -q support

В результате выполнения этой команды отобразится страница FAQ Who supports Perl? WiD develops it? Wiy is it free?

Другие способы доступа к документации

Во время установки Perl в вам предоставляется возможность уста-

новить документацию в традиционном man-формате. При этом стандартная документация по Perl будет конвертирована в формат шп и помещена в соответствующий каталог. В результате для доступа к документации по Perl можно будет использовать и программу perldoc, и программу man, как это обычно принято в

$ man perl

При установке в Windows пакета ActiveState страницы справочного руководства конвертируются в формат HTML, в результате их можно просмотреть в любом Web-броузере, который поддерживает фреймы. При стандартной установке файлы документации находятся в каталога l\html. Если вы установили Perl в другой каталог, ищите файлы документации в подкаталоге html.

В пакет MacPerl входит утилита Shuck, которая находится в папке MacPerl. Используйте ее для поиска и чтения разделов документации, как показано на рис. 1.4.

А если документация отсутствует?

Существуют лишь две причины, по которым вы не сможете найти документацию. Во-первых, нужно знать, где искать. Утилита perldoc может быть расположена в каталоге, отсутствующем в списке путей оболочки. В этом случае найдите программу

perldoc и добавьте путь к ее каталогу в переменную окружения оболочки PATH. Во-

вторых, документация могла быть нечаянно или по злому умыслу удалена. Любая установка Perl обязательно содержит документацию, более того, Perl никогда не инстал-

лируется без документации. Ее отсутствие свидетельствует о том, что пакет Perl или с самого начала неправильно установлен, или впоследствии б1л поврежден. В этом случае, вероятно, вам (или системному администратору) придется переустановить Perl. Документация является важной составляющей среды разработки Perl и без нее некоторые части Perl просто не будут функционировать.

Рис, 1.. ил Shuck используется для просмотра доку-менпа4ии по MacPerl

Если еше что-либо произошло и вы не можете получить доступ к локальной копии документации, вам придется снова обратиться к Web-серверу. На главной странице http: www.perl.com есть ссылка на страницу документации. Конечно, лучше всегда иметь под рукой документацию, относящуюся к вашей конкретной версии Perl, но в крайнем случае подойдет и эта.

Ваша первая программа

Чтобы написать программу на языке Perl, необходимо иметь текстовый редактор, который позволяет набрать неформатированный текст и сохранить его в файле. В качестве примера простых текстовых редакторов можно привести программу Notepad (Блокнот) в Microsoft Windows и 1T.E в DOS. В UNIX имеются текстовые редакторы vi, emacs и pico. По крайней мере, один из них должен быть на вашем компьютере. Па Мае приложение MacPerl содержит встроенный текстовый редактор, поэтому для создания новой программы достаточно выбрать команду File=New.

Вам не следует для набора программ на Perl нользоваться текстовым нроцессором. Текстовые нроцессоры (такие как Microsoft Word, Wordpad, WordPerfect и др.) сохраняют документы вместе с информацией об их форматировании, даже если вы не используете специальных атрибутов форматирования. Интерпретатор Perl не понимает эти коды и поэтому программы, набранные в текстовом процессоре, не будут работать. Если все же вы решите воспользоваться текстовым процессором, не забудьте сохранить программы в виде обычного текстового файла.

Нало рат1 с Perl

Наберите вашу первую программу

Откройте текстовый редактор и наберите следующую программу: !/usr/bin/perl

print "Hello, Worlci!\n";

Строка ! должна быть первой строкой файла.

После того как вы наберете эту программу в текстовом редакторе, сохраните ее в файле под .названием hello. Расширение не обязательно, но если хотите, можете его указать. Некоторые приложения Windows и Macintosh используют расширения для определения типа файлов. Если по какой-то причине вы решили дать расширение, то лучше воспользуйтесь стапдартпыми - .р1 или .р1х. Для определеппости назовите

набранный файл hello.pl.

Запуск программы

Для запуска программы необходимо перейти в режим командной строки. В UNIX зарегистрируйтесь в системе и откройте окно терминала. В Microsoft Windows откройте сеанс MS-DOS. Перейдите в каталог, где находится программа hello, используя

команду оболочки cd.

Наберите в командной строке следующее. показана командная строка DOS,

приглашение командной строки UNIX несколько отличается.) perl hello Должно появиться сообщение:

flello, World!

Если у вас получилось, примите наши поздравления! Запомните способ запуска этой программы, потому что подобным образом мы будем запускать программы на

протяжении всей книги. (Существуют и другие способы, мы вам расскажем и о них.)

Если что-то не получилось, проверьте следующее.

• Есл лось сообщение об ошибке Bad comnd or file name или perl: command not found, посмотрите, в каком каталоге находится программа perl, и

добавьте путь к ней в переменную оболочки PATH.

• Сообщение об ошибке Canen perl script hello: A file or directory does not exist говорит о том, что либо файл hello находится в другом каталоге, либо вы сохранили его под другим именем.

• Ошибка syntax error означает, что интерпретатор г1 нормально запустился, но программа не может определить, что же находится в файле hello. Например, вы могли ошибиться при наборе, или тестовый процессор добавил в сохраненный файл коды форматирования, Для просмотра содержимого файла в

UNIX воспользуйтесь командой cat, а в DOS - type. Тщательно проверьте содержимое файла, обращая внимание на кавычки и знаки пунктуации.

Если вы используете пакет Mac Perl, просто выберите команду Run "hello" в меню Script, и ваша программа запустится. Если для набора программы вы не пользовались встроенным тестовым редактором, откройте программы с команды Open

меню File, а затем выполните команду Run.