Перевод: for_next, foreach_next, gosub_return, if_endif, others, repeat_until, select_endselect, while_wend

Author: LinXP

Russian/Reference/for_next.txt

@@ -2,23 +2,23 @@
 
 @Syntax
 
-  @Keyword For <variable> = <expression1> @Keyword To <expression2> [@Keyword Step <constant>]
+  @Keyword For <переменная> = <выражение1> @Keyword To <выражение2> [@Keyword Step(Шаг) <константа>]
     ...
-  @Keyword Next [<variable>]
+  @Keyword Next [<переменная>]
 
 @Description
 
-  @Keyword For : @Keyword Next is used to create a loop within a program with the given parameters.
-  At each loop the <variable> value is increased by a 1, (or of the "Step value" if a @Keyword Step value 
-  is specified) and when the <variable> value is above the <expression2> value, the loop stop. 
+  Оператор @Keyword For : @Keyword Next используется для создания в программе цикла с заданными параметрами.
+  На каждой итерации значение <переменной> увеличивается на 1, (или на "значение Шага" если задано значение @Keyword Step),
+  и когда значение <переменной> станет больше значения <выражения2>, цикл прекращается.
   @LineBreak
   @LineBreak
-  With the @ReferenceLink "Break_Continue" Break command its possible to exit the @Keyword For : @Keyword Next loop at any moment,
-  with the @ReferenceLink "Break_Continue" Continue command the end of the current iteration can be skipped. 
+  С помощью команды @ReferenceLink "Break_Continue" Break можно выйти из цикла @Keyword For : @Keyword Next в любой момент,
+  с помощью команды @ReferenceLink "Break_Continue" Continue можно пропустить остаток текущей итерации.
   @LineBreak
   @LineBreak
-  The @Keyword "For : Next" loop works only with integer values, at the expressions as well 
-  at the @Keyword "Step" constant. The @Keyword "Step" constant can also be negative.
+  Цикл @Keyword "For : Next" работает только с целочисленными значениями, и для выражений, и для константы @Keyword "Step".
+  Константа @Keyword "Step" также может быть отрицательной.
 
 @Example 
 
@@ -28,7 +28,7 @@
   Next
 @EndCode
 
-  In this example, the program will loop 11, time (0 to 10), then quit.
+  В этом примере программа повторит цикл 11 раз (от 0 до 10), затем выйдет.
 
 @Example 
 
@@ -38,7 +38,7 @@
   Next
 @EndCode
 
-  In this example, the program will loop 10 times (10 to 1 backwards), then quit.
+  В этом примере программа повторит цикл 10 раз (от 10 уменьшаясь до 1), затем выйдет.
 
 @Example 
 
@@ -50,9 +50,9 @@
   Next k  
 @EndCode
 
-  Here, the program will loop 4 times before quitting, (k is increased by a value of 2 at each loop, 
-  so the k value is: 4-6-8-10). The "k" after the "Next" indicates that "Next" is ending the "For k" loop.
-  If another variable, is used the compiler will generate an error. It can be useful to nest several "For/Next" loops.
+  Здесь программа повторит цикл 4 раза прежде чем выйти, (k увеличивается на 2 на каждой итерации,
+  так что значение k будет: 4-6-8-10). Идентификатор "k" после "Next" показывает, что "Next" заканчивает цикл "For k".
+  Если использовать другую переменную, компилятор сообщит об ошибке. Это может быть полезно для организации нескольких вложенных циклов "For/Next".
 
 @Example
 
@@ -64,5 +64,5 @@
   Next x
 @EndCode
 
-  @Bold Note: Be aware, that in PureBasic the value of <expression2> ('To' value) can also be changed inside 
-  the For : Next loop. This can lead to endless loops when wrongly used. 
+  @Bold Примечание: Учтите, что в PureBasic значение <выражения2> (значение 'To') также можно изменить внутри цикла For : Next.
+  При неправильном использовании это может привести к бесконечным повторам.

Russian/Reference/foreach_next.txt

@@ -8,20 +8,20 @@
 
 @Description 
 
-  @Keyword ForEach loops through all elements in the specified list or map starting from the first 
-  element up to the last. If the list or the map is empty, @Keyword ForEach : @Keyword Next exits immediately. 
-  To view all commands used to manage lists, please click @LibraryLink "List" "here".
-  To view all commands used to manage maps, please click @LibraryLink "Map" "here". @LineBreak
+  Цикл @Keyword ForEach проходит по всех элементам заданного связанного списка или отображения, начиная
+  с первого элемента до последнего. Если список или отображение пусто, цикл @Keyword ForEach : @Keyword Next немедленно выходит.
+  Чтобы увидеть все команды работы со списками, пожалуйста кликните @LibraryLink "List" "здесь".
+  Чтобы увидеть все команды работы с отображениями, пожалуйста кликните @LibraryLink "Map" "здесь". @LineBreak
   @LineBreak
-  When used with list, it's possible to @Link "List/DeleteElement" "delete" or @Link "List/AddElement" "add" elements
-  during the loop. As well it's allowed to change the current element with @@ChangeCurrentElement.
-  After one of the mentioned changes the next loop continues with the element following the current element.
+  При использовании со связанным списком можно @Link "List/DeleteElement" "удалять" или @Link "List/AddElement" "добавлять" элементы
+  внутри цикла. Также разрешено передвигать текущий элемент с помощью функции @@ChangeCurrentElement.
+  После любого из названных изменений цикл продолжится с элемента, следующего за текущим элементом.
   @LineBreak
   @LineBreak
-  With the @ReferenceLink "Break_Continue" Break command its possible to exit the @Keyword ForEach : @Keyword Next loop
-  at any moment, with the @ReferenceLink "Break_Continue" Continue command the end of the current iteration can be skipped. 
+  С помощью команды @ReferenceLink "Break_Continue" Break можно выйти из цикла @Keyword ForEach : @Keyword Next в любой момент,
+  с помощью команды @ReferenceLink "Break_Continue" Continue можно пропустить остаток текущей итерации.
 
-  @Example list
+  @Example Связанный список (list)
 
 @Code       
   NewList Number()
@@ -36,18 +36,18 @@
   Number() = 30
 
   ForEach Number()
-    Debug Number() ; Will output 10, 20 and 30
+    Debug Number() ; Выведет 10, 20 и 30
   Next
 @EndCode  
 
-  @Example Map
+  @Example Отображение (Map)
 
 @Code       
   NewMap Country.s()
 
-  Country("US") = "United States"
-  Country("FR") = "France"
-  Country("GE") = "Germany"
+  Country("UA") = "Украина"
+  Country("RU") = "Россия"
+  Country("US") = "США"
 
   ForEach Country()
     Debug Country()

Russian/Reference/gosub_return.txt

@@ -11,18 +11,18 @@
 
 @Description
 
-  @Keyword Gosub stands for 'Go to sub routine'. A @ReferenceLink "general_rules" "label" must be specified after @Keyword Gosub, at that point 
-  the program execution continues immediately after the position defined by that label, and will do so until 
-  encountering a @Keyword Return. When a return is reached, the program execution is then transferred immediately 
-  below the @Keyword Gosub.
+  Команда @Keyword Gosub буквально означает 'Иди в подпрограмму' и используется для вызова подпрограммы MyLabel.
+  После @Keyword Gosub должна быть указана @ReferenceLink "general_rules" "метка" подпрограммы,
+  программа продолжит выполнение с позиции, заданной этой меткой, и будет делать это пока не встретит @Keyword Return.
+  После выполнения команды @Keyword Return, программа вернется к строке, следующей за командой @Keyword Gosub.
   @LineBreak
-  @Keyword Gosub is useful when building fast structured code.
+  Команда @Keyword Gosub полезна для создания быстрого структурированного кода.
   @LineBreak
   @LineBreak
-  Another technique which may be used in order to insert a sub routine into a standalone program component 
-  is to use @ReferenceLink "procedures" "procedures".
-  @Keyword Gosub may only be used within the main body of the source code, and may not be used within 
-  @ReferenceLink "procedures" "procedures".
+  Другой приём, с помощью которого можно вставить подпрограмму в самостоятельный компонент программы,
+  это @ReferenceLink "procedures" "процедуры".
+  @Keyword Gosub можно использовать только внутри основного кода, но нельзя использовать внутри
+  @ReferenceLink "procedures" "процедур".
 
   @Example
 
@@ -45,9 +45,12 @@
 
 @Description
 
-  If the command @ReferenceLink "Others" Goto is used within the body of a sub routine, @Keyword FakeReturn must be used.
-  @Keyword FakeReturn simulates a return without actually executing a return, and if it is not used, the program will crash.
-  Note: To exit a loop safely, @ReferenceLink "break_continue" "Break" should be used instead of Goto. 
+  Если Вы хотите совершить прыжок (@ReferenceLink "Others" Goto) из подпрограммы в другую часть кода (вне подпрограммы)
+  - следует использовать @Keyword FakeReturn для имитации выхода из подпрограммы.
+  @Keyword FakeReturn имитирует @Keyword Return без выполнения возврата, и если его не использовать, программа даст сбой. @LineBreak
+  Примечание 1: Чтобы безопасно завершить цикл, вместо @ReferenceLink "Others" Goto следует использовать @ReferenceLink "break_continue" "Break". @LineBreak
+  Примечание 2: Не рекомендуется использовать эту команду, потому что хорошо созданная программа не использует @ReferenceLink "Others" Goto.
+  Но иногда, по причине быстродействия, это может помочь программисту.
 
   @Example
 

Russian/Reference/if_endif.txt

@@ -2,24 +2,24 @@
 
 @Syntax
 
-  @Keyword If <expression> 
+  @Keyword If <переменная>
     ...
-  [@Keyword ElseIf <expression>]
+  [@Keyword ElseIf <переменная>]
     ...
   [@Keyword Else]
     ...
   @Keyword EndIf 
 
 @Description
 
-  The @Keyword If structure is used to achieve tests, and/or change the programmes direction, depending on whether the test is true or false. 
-  @Keyword ElseIf optional command is used for any number of additional tests if the previous test was not true. 
-  The @Keyword Else optional command is used to execute a part of code, if all previous tests were false. 
-  Any number of @Keyword If structures may be nested together. @LineBreak
+  Структура @Keyword If используется для проверок, и/или изменения хода выполнения программы, в зависимости от истинности или ложности результата проверки.
+  Необязательная команда @Keyword ElseIf используется для любого количества добавочных проверок, если предыдущая проверка не была истинной.
+  Необязательная команда @Keyword Else используется для выполнения части кода в том случае, если все предыдущие проверки были ложными.
+  Можно вложить друг в друга любое количество структур @Keyword If. @LineBreak
   @LineBreak
-  Short-circuit evaluations for expressions are supported, meaning if a test is true, all following tests will be ignored and not even run.
+  Проверки "Короткого замыкания" для выражений поддерживаются, это означает, если проверка выполнена, то все следующие тесты будут игнорироваться, и даже не выполняться.
 
-  @Example Basic test
+  @Example Простая проверка
 
 @Code
   a = 5
@@ -30,33 +30,33 @@
   EndIf    
 @EndCode
 
-  @Example Multiple test
+  @Example Несколько проверок
 
 @Code
   b = 15
   If a = 10 And b >= 10 Or c = 20     
     If b = 15
       Debug "b = 15"
     Else       
-      Debug "Other possibility"
+      Debug "Другая возможность"
     EndIf   
   Else     
-    Debug "Test failure"
+    Debug "Проверка не пройдена"
   EndIf  
 @EndCode
 
-  @Example Short-circuit test
+  @Example Проверка "Короткое замыкание"
 
 @Code
   Procedure DisplayHello()
-    Debug "Hello"
+    Debug "Привет"
     ProcedureReturn 1
   EndProcedure
 
   a = 10
-  If a = 10 Or DisplayHello() = 1 ; a is equal to 10, so the second test is fully ignored
-    Debug "Test success"
+  If a = 10 Or DisplayHello() = 1 ; значение "а" равно 10, так что второй тест полностью игнорируется
+    Debug "Проверка пройдена"
   Else     
-    Debug "Test failure"
+    Debug "Проверка не пройдена"
   EndIf  
 @EndCode

Russian/Reference/others.txt

@@ -1,15 +1,15 @@
-@Title Others Commands 
+@Title Другие команды
 
 @Syntax
 
-  @Keyword Goto <label>
+  @Keyword Goto <метка>
 
 @Description
 
-  This command is used to transfer the program directly to the labels position. Be cautious when using 
-  this function, as incorrect use could cause a program to crash... @LineBreak
+  Эта команда используется для перевода программы прямо к позиции <метка>. Будьте осторожны
+  при использовании этой функции, так как некорректное использование может вызвать сбой программы...  @LineBreak
   @LineBreak
-  Note: To exit a loop safely, you always should use @ReferenceLink "Break_Continue" Break instead of @Keyword Goto. 
+  Примечание: Чтобы безопасно выйти из цикла, вам всегда следует использовать @ReferenceLink "Break_Continue" Break вместо @Keyword Goto. 
 
 ; ---------------------------------------------------------------------------------------------------
 
@@ -19,48 +19,59 @@
 
 @Description
 
-  Ends the program execution correctly. The 'ExitCode' optional parameter can be specified if the 
-  program need to returns an error code (widely used in console programs). 
+  Корректно заканчивает выполнение программы. Можно задать необязательный параметр 'ExitCode', если программа
+  должна возвратить код ошибки (широко используется в консольных программах).
   @LineBreak
   @LineBreak
-  The 'ExitCode' can be further used e.g. with the @@ProgramExitCode command.
+  'ExitCode' может в дальнейшем использоваться например с командой @@ProgramExitCode.
+
+@Example
+@Code
+  Program = RunProgram("Vasha_programma.exe", "Параметр", "C:\rabochaya_papka_vashei_programmi\", #PB_Program_Wait)
+  ; Прога Vasha_programma.exe запущена с параметром Параметр и с рабочей папкой C:\rabochaya_papka_vashei_programmi\,
+  ; программа, запустившая её, ожидает завершения проги Vasha_programma.exe
+
+  Result = ProgramExitCode(Program); по завершении программы Vasha_programma.exe запустившая её программа получит exitcode
+@EndCode
 
 ; ---------------------------------------------------------------------------------------------------
 
 @Syntax
 
-  @Keyword Swap <expression>, <expression>
+  @Keyword Swap <выражение>, <выражение>
 
 @Description
 
-  Swaps the value of the both expression, in an optimized way. The both <expression> have to be
-  a @ReferenceLink "variables" "variable", @ReferenceLink "dim" "array", @ReferenceLink "newlist" "list" or a  @ReferenceLink "newmap" "map"
-  element (structured or not) and have to be one of the
-  PureBasic native type like long (.l), quad (.q), string etc.
+  Изменяет значения обоих выражений оптимизированным способом, меняя их местами. Оба <выражения> должны
+  быть @ReferenceLink "variables" "переменными", @ReferenceLink "dim" "массивами", @ReferenceLink "newlist" "связанными списками" или
+  элементы @ReferenceLink "newmap" "отображения"  (структурированного или нет) и принадлежать одному из
+  @ReferenceLink "variables" "типов" PureBasic, такому как long (.l), quad (.q), string и т.д.
 
-@Example Swapping of strings
+@Example Обмен строк
 @Code
-  Hello$ = "Hello"
-  World$ = "World"
+  Hello$ = "Привет"
+  World$ = "Мир"
+  
+  Debug Hello$+" "+World$ ; выведет "Привет Мир"
 
   Swap Hello$, World$
 
-  Debug Hello$+" "+World$
+  Debug Hello$+" "+World$ ; выведет "Мир Привет"
 @EndCode
 
-@Example Swapping of multi-dimensional arrays elements
+@Example Обмен многомерных массивов
 @Code
   Dim Array1(5,5) 
   Dim Array2(5,5) 
-  Array1(2,2) = 10     ; set initial contents
+  Array1(2,2) = 10     ; задаём начальное содержание
   Array2(3,3) = 20
 
-  Debug Array1(2,2) ; will print 10
-  Debug Array2(3,3) ; will print 20
+  Debug Array1(2,2) ; выведет 10
+  Debug Array2(3,3) ; выведет 20
 
-  Swap Array1(2,2) , Array2(3,3)  ; swap 2 arrays elements
+  Swap Array1(2,2) , Array2(3,3)  ; обмениваем 2 элемента массивов
 
-  Debug "Array contents after swapping:"
-  Debug Array1(2,2)    ; will print 20
-  Debug Array2(3,3)    ; will print 10
+  Debug "Содержание массивов после обмена:"
+  Debug Array1(2,2)    ; выведет 20
+  Debug Array2(3,3)    ; выведет 10
 @EndCode