Difference between revisions of "Program/ru"

From Lazarus wiki
Jump to navigationJump to search
 
(One intermediate revision by the same user not shown)
Line 41: Line 41:
 
FPC не поддерживает несколько модулей в одном файле исходного кода, как это делали или делают некоторые другие компиляторы. Исходный код каждого модуля должен находиться в отдельном файле. Однако ограничение, согласно которому имена модулей должны совпадать с именами файлов, не применяется к программам. Это связано с тем, что программы не могут быть включены другими модулями, поэтому их поиск (по имени файла) не требуется.
 
FPC не поддерживает несколько модулей в одном файле исходного кода, как это делали или делают некоторые другие компиляторы. Исходный код каждого модуля должен находиться в отдельном файле. Однако ограничение, согласно которому имена модулей должны совпадать с именами файлов, не применяется к программам. Это связано с тем, что программы не могут быть включены другими модулями, поэтому их поиск (по имени файла) не требуется.
  
== Program structure ==
+
== Структура программы ==
  
A <syntaxhighlight lang="pascal" inline>program</syntaxhighlight> file has to follow a certain [[Program Structure|structure]].
+
Файл <syntaxhighlight lang="pascal" inline>program</syntaxhighlight> должен иметь определенную [[Basic_Pascal_Tutorial/Chapter_1/Program_Structure/ru|структуру]].
# A (depending on used compiler possibly optional) program header.
 
# There can be at most one [[Uses|<syntaxhighlight lang="pascal" inline>uses</syntaxhighlight>-clause]] and it has to be at the top of the program right after the program header.
 
# Exactly one [[Block|block]] that concludes with an <syntaxhighlight lang="pascal" inline>end.</syntaxhighlight> (note the [[period#module end|period]]). This block may contain – in contrast to regular blocks – <syntaxhighlight lang="pascal" inline>resourcestring</syntaxhighlight> section(s).
 
The exact order and number of various sections after the (optional) <syntaxhighlight lang="pascal" inline>uses</syntaxhighlight>-clause until final the compound statement [[Begin|<syntaxhighlight lang="pascal" inline>begin</syntaxhighlight>]]…[[End|<syntaxhighlight lang="pascal" inline>end.</syntaxhighlight>]] is free of choice.
 
  
However, there are some plausible considerations.
+
# Заголовок программы (в зависимости от используемого компилятора, возможно, необязательный).
* A [[Type|<syntaxhighlight lang="pascal" inline>type</syntaxhighlight>-section]] comes prior any section that can use types, e.g. [[Var|<syntaxhighlight lang="pascal" inline>var</syntaxhighlight>-sections]] or [[Routine|routine]] declarations.
+
# Может быть не более одного раздела [[Uses|<syntaxhighlight lang="pascal" inline>uses</syntaxhighlight>-clause]], и оно должно быть в верхней части программы сразу после заголовка программы.
* Since [[Goto|<syntaxhighlight lang="pascal" inline>goto</syntaxhighlight>]] is known as the devil’s tool, a [[Label|<syntaxhighlight lang="pascal" inline>label</syntaxhighlight>-section]], if any, is as close as possible to the statement-frame it is supposed to declare labels for.
+
# Ровно один [[Block|блок]], заканчивающийся <syntaxhighlight lang="pascal" inline>end</syntaxhighlight>(обратите внимание на [[period#module end|period]]). Этот блок может содержать — в отличие от обычных блоков — раздел(ы) <syntaxhighlight lang="pascal" inline>resourcestring</syntaxhighlight>.
* Generally you go from general into specifics: For example a <syntaxhighlight lang="pascal" inline>var</syntaxhighlight>-section comes in front of a [[Threadvar|<syntaxhighlight lang="delphi" inline>threadVar</syntaxhighlight>-section]]. A [[Const|<syntaxhighlight lang="pascal" inline>const</syntaxhighlight>-section]] comes before a [[Resourcestring|<syntaxhighlight lang="delphi" inline>resourceString</syntaxhighlight>-section]].
 
* <syntaxhighlight lang="delphi" inline>resourceString</syntaxhighlight>-sections can be either static or global, that means they should appear relatively soon after the <syntaxhighlight lang="pascal" inline>uses</syntaxhighlight>-clause.
 
* Direct usage of [[Global variables|global variables]] in routines (or even the mere possibility) is considered as bad style. Instead, declare/define your routines prior any <syntaxhighlight lang="pascal" inline>var</syntaxhighlight>-(like)-section. (beware: play it safe and set <syntaxhighlight lang="pascal" inline>{$writeableConst off}</syntaxhighlight>)
 
* [[global compiler directives|Global compiler directives]], especially such that allow or restrict what can be written (e.g. <syntaxhighlight lang="pascal" inline>{$goto on}</syntaxhighlight> allows the use of <syntaxhighlight lang="pascal" inline>goto</syntaxhighlight>) or implicitly add unit dependencies like [[Mode ObjFPC|<syntaxhighlight lang="pascal" inline>{$mode objFPC}</syntaxhighlight>]] should appear soon after the program header.
 
  
Taking all considerations into account the rough program structure should look like this (except for <syntaxhighlight lang="pascal" inline>label</syntaxhighlight> and [[sGoto|<syntaxhighlight lang="pascal" inline>{$goto on}</syntaxhighlight>]] which are only mentioned for the sake of completeness):
+
Точный порядок и количество различных разделов после (необязательного) предложения <syntaxhighlight lang="pascal" inline>uses</syntaxhighlight> до окончательного составного оператора [[Begin|<syntaxhighlight lang="pascal" inline>begin</syntaxhighlight>]]…[[End|<syntaxhighlight lang="pascal" inline>end</syntaxhighlight>]] строго не определен.
 +
 
 +
Тем не менее, есть некоторые правдоподобные соображения.
 +
 
 +
* Раздел [[Type|<syntaxhighlight lang="pascal" inline>type</syntaxhighlight>-section]] предшествует любому разделу, который может использовать типы, например,[[Var|<syntaxhighlight lang="pascal" inline>var</syntaxhighlight>]]-разделы или объявления [[Routine|подпрограмм]].
 +
* Поскольку [[Goto|<syntaxhighlight lang="pascal" inline>goto</syntaxhighlight>]] известен как "инструмент дьявола", раздел [[Label|<syntaxhighlight lang="pascal" inline>label</syntaxhighlight>]], если он есть, максимально близок к фрейму оператора, для которого он должен объявлять метки.
 +
* Как правило, вы переходите от общего к частному: например, <syntaxhighlight lang="pascal" inline>var</syntaxhighlight>-раздел идет перед разделом [[Threadvar|<syntaxhighlight lang="delphi" inline>threadVar</syntaxhighlight>]]. Раздел [[Const|<syntaxhighlight lang="pascal" inline>const</syntaxhighlight>]] предшествует разделу [[Resourcestring|<syntaxhighlight lang="delphi" inline>resourceString</syntaxhighlight>]].
 +
* Разделы <syntaxhighlight lang="delphi" inline>resourceString</syntaxhighlight> могут быть как статическими, так и глобальными, что означает, что они должны появиться относительно скоро после предложения <syntaxhighlight lang="pascal" inline>uses</syntaxhighlight>.
 +
* Прямое использование [[Global variables|глобальных переменных]] в подпрограммах (или даже простое их использование) считается дурным тоном. Вместо этого объявляйте/определяйте свои подпрограммы до любого <syntaxhighlight lang="pascal" inline>var</syntaxhighlight>-(подобного)-раздела. (осторожно: не рискуйте и задайте <syntaxhighlight lang="pascal" inline>{$writeableConst off}</syntaxhighlight>)
 +
* [[global compiler directives|Глобальные директивы компилятора]], особенно те, которые разрешают или ограничивают то, что может быть написано (например, <syntaxhighlight lang="pascal" inline>{$goto on}</syntaxhighlight> позволяет использовать <syntaxhighlight lang="pascal" inline>goto</syntaxhighlight>) или неявно добавляют зависимости модулей, такие как [[Mode ObjFPC|<syntaxhighlight lang="pascal" inline>{$mode objFPC}</syntaxhighlight>]], должны появляться вскоре после заголовка программы.
 +
 
 +
Принимая во внимание все соображения, примерная структура программы должна выглядеть так (за исключением <syntaxhighlight lang="pascal" inline>label</syntaxhighlight> и [[sGoto|<syntaxhighlight lang="pascal" inline>{$goto on}</syntaxhighlight>]], которые упоминаются только для полноты картины):
  
 
<syntaxhighlight lang="delphi">
 
<syntaxhighlight lang="delphi">
 
program sectionDemo(input, output, stdErr);
 
program sectionDemo(input, output, stdErr);
  
// Global compiler directives ----------------------------
+
// Глобальные директивы компилятора ----------------------------
 
{$mode objFPC}
 
{$mode objFPC}
 
{$goto on}
 
{$goto on}
Line 95: Line 98:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
<small>[The example consciously ignores the possibility of “typed constants”, sticking rather to traditional concepts than unnecessarily confusing beginners.]</small>
+
<small>[Пример сознательно игнорирует возможность «типизированных констант», придерживаясь скорее традиционных концепций, чем невольно сбивает с толку новичков.]</small>
  
== See also ==
+
== См.также ==
  
 
* [[Unit|unit]]
 
* [[Unit|unit]]

Latest revision as of 19:09, 29 May 2022

Deutsch (de) English (en) suomi (fi) français (fr) Bahasa Indonesia (id) italiano (it) português (pt) русский (ru)

Понятие программа означает либо исполняемая программа, т.е. самодостаточное и запускаемое приложение, либо часть файла (файлов) с исходным кодом на языке Pascal, который может быть скомпилирован и не объявлен в виде модуля или библиотеки. Иногда оно называется главной программой.

Главная программа

program — это зарезервированное слово, которое представляет файл с исходным кодом классической программы:

program hiWorld(input, output, stdErr);

begin
	writeLn('Hi!');
end.

Тем временем FPC отбрасывает заголовок программы, т.е. первую строку. Имя выходного файла определяется именем файла исходного кода. Однако имя программы становится зарезервированным идентификатором (за исключением режимов ISO [начиная с [FPC 3.3.1/trunk revision #45757; cf. Issue #37322]). В приведенном выше примере, например. попытка определить константу с именем hiWorld вызовет ошибку времени компиляции повторяющегося идентификатора. Имя программы идентифицирует глобальную область, поэтому его можно использовать для записи полных идентификаторов.

Список файловых дескрипторов полностью игнорируется, за исключением {$mode ISO}. Текстовые переменные input, output и stderr всегда открыты и их имена нельзя изменить в других режимах. (ср.: SysInitStdIO всегда вызывается в rtl/linux/system.pp)

Поэтому с помощью FPC следующий полный пример исходного кода компилируется так же, как и предыдущий пример.

begin
	writeLn('Hi!');
end.

Если программа синтаксически верна, FPC игнорирует все, что идет после финального end.. Следующее будет скомпилировано без проблем:

program awesomeProgram(input, output, stdErr);
begin
	writeLn('Awesome!');
end. Я благодарю маму, папу и всех, кто поддерживал меня в создании этой программы.

Эта «функция» в основном используется для предоставления журнала изменений в файле или уведомления об авторских правах.

FPC не поддерживает несколько модулей в одном файле исходного кода, как это делали или делают некоторые другие компиляторы. Исходный код каждого модуля должен находиться в отдельном файле. Однако ограничение, согласно которому имена модулей должны совпадать с именами файлов, не применяется к программам. Это связано с тем, что программы не могут быть включены другими модулями, поэтому их поиск (по имени файла) не требуется.

Структура программы

Файл program должен иметь определенную структуру.

  1. Заголовок программы (в зависимости от используемого компилятора, возможно, необязательный).
  2. Может быть не более одного раздела uses-clause, и оно должно быть в верхней части программы сразу после заголовка программы.
  3. Ровно один блок, заканчивающийся end(обратите внимание на period). Этот блок может содержать — в отличие от обычных блоков — раздел(ы) resourcestring.

Точный порядок и количество различных разделов после (необязательного) предложения uses до окончательного составного оператора beginend строго не определен.

Тем не менее, есть некоторые правдоподобные соображения.

  • Раздел type-section предшествует любому разделу, который может использовать типы, например,var-разделы или объявления подпрограмм.
  • Поскольку goto известен как "инструмент дьявола", раздел label, если он есть, максимально близок к фрейму оператора, для которого он должен объявлять метки.
  • Как правило, вы переходите от общего к частному: например, var-раздел идет перед разделом threadVar. Раздел const предшествует разделу resourceString.
  • Разделы resourceString могут быть как статическими, так и глобальными, что означает, что они должны появиться относительно скоро после предложения uses.
  • Прямое использование глобальных переменных в подпрограммах (или даже простое их использование) считается дурным тоном. Вместо этого объявляйте/определяйте свои подпрограммы до любого var-(подобного)-раздела. (осторожно: не рискуйте и задайте {$writeableConst off})
  • Глобальные директивы компилятора, особенно те, которые разрешают или ограничивают то, что может быть написано (например, {$goto on} позволяет использовать goto) или неявно добавляют зависимости модулей, такие как {$mode objFPC}, должны появляться вскоре после заголовка программы.

Принимая во внимание все соображения, примерная структура программы должна выглядеть так (за исключением label и {$goto on}, которые упоминаются только для полноты картины):

program sectionDemo(input, output, stdErr);

// Глобальные директивы компилятора ----------------------------
{$mode objFPC}
{$goto on}

uses
	sysUtils;

const
	answer = 42;

resourceString
	helloWorld = 'Hello world!';

type
	primaryColor = (red, green, blue);

procedure doSomething(const color: primaryColor);
begin
end;

// M A I N -----------------------------------------------
var
	i: longint;

threadVar
	z: longbool;

label
	42;
begin
end.

[Пример сознательно игнорирует возможность «типизированных констант», придерживаясь скорее традиционных концепций, чем невольно сбивает с толку новичков.]

См.также