Ru:Introduction to SourcePawn - Revision history

Frenzzy at 18:10, 25 June 2011

2011-06-25T18:10:32Z

Droper: /* Особенности языка */

2011-02-06T16:49:02Z

‎Особенности языка

Frenzzy: /* Локальный static */

2008-12-26T12:42:50Z

‎Локальный static

Frenzzy: /* Local static */

2008-12-26T12:42:00Z

‎Local static

Frenzzy: /* Global static */

2008-12-26T12:27:53Z

‎Global static

Frenzzy: /* Global static */

2008-12-26T12:27:36Z

‎Global static

Frenzzy: /* static */

2008-12-26T12:21:13Z

‎static

Frenzzy: /* Notes */

2008-12-26T12:18:45Z

‎Notes

Frenzzy: /* Golden Rules */

2008-12-26T12:10:41Z

‎Golden Rules

Frenzzy: /* Caveats */

2008-12-26T12:03:32Z

‎Caveats

@@ Line 229: / Line 229: @@
 *'''обратный вызов''' - Применение вызова функций в Вашем коде, как если бы это было событием триггера (совокупность условий, инициирующих выполнение действия).
-Существуют пять видов функций:
+Существуют шесть видов функций:
 *'''native''': Прямая, внутренняя функция, предусмотренная в приложении.
 *'''public''': Функция обратного вызова, что делает её видимой для приложения и других сценариев.
 *'''normal''': Нормальная функция, которую Вы можете только вызвать.
 *'''stock''': Нормальная функция, предусмотренная если включает в себя файл. Если не используется, то не компилируется.
 *'''forward''': Эта функция представляет собой глобальное событие, предусмотренная приложением. Если Вы её привели в исполнение, она будет вызвона.
@@ Line 314: / Line 315: @@
 ==Natives==
-Natives имеют встроенные функции, предоставляемые приложением. Вы можете вызвать их, как если бы они были normal функциями. Например, SourceMod имеет следующие функции:
+Natives имеют встроенные функции, предоставляемые SourceMod. Вы можете вызвать их, как если бы они были normal функциями. Например, SourceMod имеет следующие функции:
 <pawn>native FloatRound(Float:num);</pawn>
@@ Line 373: / Line 374: @@
 new c = AddTwoNumbers(a, b) + (a * b);
 </pawn>
 ==Операторы==
@@ Line 830: / Line 833: @@
 ===Примечания===
-Этот пример НЕ является столь эффективным, как <tt>decl</tt>:
+Обратите внимание, что <tt>decl</tt> переменную инициализировать явно, но '''ТОЛЬКО''' как строку:
 <pawn>
-new String:blah[512] = "a";
+decl Float:blah[512] = {1.0};
 </pawn>

@@ Line 61: / Line 61: @@
 *'''Pawn не собирает мусор''' Pawn, как язык, не имеет встроенных ресурсов памяти, и потому он не мусорит. Если функция выделит память, то Вы отвечаете за её освобождение.
 *'''Pawn не объектно-ориентированный язык''' Pawn является процедурным, и полагается на подпрограммы. Также у него нету C подобных структур.
-*'''Pawn не функциональный.''' Pawn является процедурным, и не поддерживает функции "лямбды" (Lambda), поздние присвоения, и все то, что можно найти в языках высшего уровня, таких как Phyton и Ruby.
+*'''Pawn не функциональный.''' Pawn является процедурным, и не поддерживает функции "лямбды" (Lambda), поздние присвоения, и все то, что можно найти в языках высшего уровня, таких как Python и Ruby.
 *'''Pawn однопоточный''' As of this writing, Pawn is not thread safe.
 *'''Pawn не интерпретируемый''' Ну, почти. Он интерпретируется на очень низком уровне. Вы должны скомпилировать код, из которого получится бинарный файл. Эта программа будет работать на той платформе, которую использует хост. Это ускоряет загрузку и позволяет легче находить ошибки.

@@ Line 876: / Line 876: @@
 MyFunction(10);</pawn>
-В этом примере, <tt>counter</tt> может быть <tt>-1 + 5 + 6 + 10</tt>, или <tt>20</tt>, поскольку она сохраняется за рамки этой функции. Это может создавать проблемы для рекурсивной функции: если ваша функция может быть рекурсивной, то <tt>static</tt>, как правило, не является хорошей идеей, если только Ваш код не реентерабельный.
+В этом примере, <tt>counter</tt> может быть <tt>-1 +5 +6 +10</tt>, или <tt>20</tt>, поскольку она сохраняется за рамками этой функции. Это может создавать проблемы для рекурсивной функции: если ваша функция может быть рекурсивной, то <tt>static</tt>, как правило, не является хорошей идеей, если только Ваш код не реентерабельный.
 Преимуществом локальных static переменных является то, что Вам не придется загромождать свой сценарий глобальными переменными. До тех пор, пока переменной не нужно читать другую функцию, Вы можете его пихать внутрь функции и её сохранение будет гарантировано.

@@ Line 856: / Line 856: @@
 Если плагин включает в себя оба этих файла, он не сможет использовать <tt>g_value1</tt> или <tt>g_value2</tt>. Это простой механизм сокрытия информации, и аналогичен элементам объявления переменных, например <tt>private</tt> в таких языках, как C++, Java, или C#.
-===Local static===
+===Локальный static===
-A local static variable is a global variable that is only visible from its local lexical scope.  For example:
+Локальная static переменная является глобальной переменной, которая является видимой лишь из её местной области действия. Например:
 <pawn>
@@ Line 869: / Line 869: @@
 }</pawn>
-In this example, <tt>counter</tt> is technically a global variable -- it is initialized once to -1 and is never initialized again.  It does not exist on the stack.  That means each time <tt>MyFunction</tt> runs, the <tt>counter</tt> variable and its storage in memory is the same.
+В этом примере, <tt>counter</tt> технически глобальная переменная -- она инициализируется один раз как -1 и никогда не инициализируется заново. Оно не существует в наборе. Это означает, что при каждом запуске функции <tt>MyFunction</tt>, переменная <tt>counter</tt> и ее хранение в памяти одно и тоже.
-Take this example:
+Возьмем следающий пример:
 <pawn>MyFunction(5);
 MyFunction(6);
 MyFunction(10);</pawn>
-In this example, <tt>counter</tt> will be <tt>-1 + 5 + 6 + 10</tt>, or <tt>20</tt>, because it persists beyond the frame of the function.  Note this may pose problems for recursive functions: if your function may be recursive, then <tt>static</tt> is usually not a good idea unless your code is re-entrant.
+В этом примере, <tt>counter</tt> может быть <tt>-1 + 5 + 6 + 10</tt>, или <tt>20</tt>, поскольку она сохраняется за рамки этой функции. Это может создавать проблемы для рекурсивной функции: если ваша функция может быть рекурсивной, то <tt>static</tt>, как правило, не является хорошей идеей, если только Ваш код не реентерабельный.
-The benefit of a local static variable is that you don't have to clutter your script with global variables.  As long as the variable doesn't need to be read by another function, you can squirrel it inside the function and its persistence will be guaranteed.
+Преимуществом локальных static переменных является то, что Вам не придется загромождать свой сценарий глобальными переменными. До тех пор, пока переменной не нужно читать другую функцию, Вы можете его пихать внутрь функции и её сохранение будет гарантировано.
-Note that statics can exist in any local scope:
+Заметим, что statics может существовать в любой локальной области действия:
 <pawn>

@@ Line 845: / Line 845: @@
 Ключевое слово <tt>static</tt> входит в глобальную и локальную область действия. Оно имеет различные значения в каждой из них.
-===Global static===
+===Глобальный static===
 Глобальные static переменные могут быть доступны только в рамках того же файла. Например:

@@ Line 846: / Line 846: @@
 ===Global static===
-A global static variable can only be accessed from within the same file.  For example:
+Глобальные static переменные могут быть доступны только в рамках того же файла. Например:
 <pawn>//file1.inc
@@ Line 854: / Line 854: @@
 static Float:g_value2 = 0.15f;</pawn>
-If a plugin includes both of these files, it will not be able to use either <tt>g_value1</tt> or <tt>g_value2</tt>.  This is a simple information hiding mechanism, and is similar to declaring member variables as <tt>private</tt> in languages like C++, Java, or C#.
+Если плагин включает в себя оба этих файла, он не сможет использовать <tt>g_value1</tt> или <tt>g_value2</tt>. Это простой механизм сокрытия информации, и аналогичен элементам объявления переменных, например <tt>private</tt> в таких языках, как C++, Java, или C#.
 ===Local static===

@@ Line 843: / Line 843: @@
 ==static==
-The <tt>static</tt> keyword is available at global and local scope.  It has different meanings in each.
+Ключевое слово <tt>static</tt> входит в глобальную и локальную область действия. Оно имеет различные значения в каждой из них.
 ===Global static===

@@ Line 829: / Line 829: @@
 *'''Не оптимизируйте преждевременно.''' Кроме того, нет необходимости использовать <tt>decl</tt> на не-массивы, поскольку нет никаких дополнительных затрат на инициализацию однго однострочного значения.
-===Notes===
+===Примечания===
-This example is NOT as efficient as a <tt>decl</tt>:
+Этот пример НЕ является столь эффективным, как <tt>decl</tt>:
 <pawn>
 new String:blah[512] = "a";
 </pawn>
-Even though the string is only one character, the <tt>new</tt> operator guarantees the rest of the array will be zeroed as well.
+Даже несмотря на то, что строка имеет только один символ, оператор <tt>new</tt> гарантирует, что остальная часть массива будет нулевой.
-Also note, it is invalid to explicitly initialize a <tt>decl</tt>:
+Также обратите внимание, он является неправильным для явной инициализации <tt>decl</tt>:
 <pawn>decl String:blah[512] = "a";</pawn>
-The above code will not compile, because the purpose of <tt>decl</tt> is to avoid any initialization.
+Приведенный выше код не будет компилироваться, потому что цель <tt>decl</tt> состоит в том, чтобы избежать каких-либо инициализаций.
 ==static==

@@ Line 825: / Line 825: @@
 </pawn>
-===Golden Rules===
+===Золотые правила===
-*'''Only use decl if in between declaring and loading/reading the value, you are absolutely sure there is at least one store/set operation that gives the variable valid data.'''
+*'''Используйте decl только, если в период объявления и загрузки/чтения значения, Вы абсолютно уверены, что есть по крайней мере одно хранилище/операция, которая отдает переменной действительные данные.'''
-*'''Do not prematurely optimize.'''  Likewise, there is no need to use <tt>decl</tt> on non-arrays, because there is no added expense for initializing a single cell value.
+*'''Не оптимизируйте преждевременно.''' Кроме того, нет необходимости использовать <tt>decl</tt> на не-массивы, поскольку нет никаких дополнительных затрат на инициализацию однго однострочного значения.
 ===Notes===

@@ Line 793: / Line 793: @@
 </pawn>
-===Caveats===
+===Предостережения===
-The downside to <tt>decl</tt> is that it means its variables will start with "garbage" contents.  For example, if we were to use:
+Обратная сторона <tt>decl</tt> состоит в том, что его переменные будут начинаться с "ненужного" содержания. Например, если мы будем использовать:
 <pawn>
@@ Line 806: / Line 806: @@
 </pawn>
-This code may crash the server, because <tt>blah</tt> may be completely corrupt (strings require a terminator, and that may not be present).  Similarly, if we did:
+Этот код может привести к падению сервера, так как массив <tt>blah</tt> может быть полностью испорчен (строки требуют нулевой символ, который может отсутствовать). Точно так же, если мы сделаем:
 <pawn>
@@ Line 816: / Line 816: @@
 </pawn>
-The value of <tt>d</tt> is now undefined.  It could be any value, negative or positive.
+Значение <tt>d</tt> в настоящее время не определенно. Оно может быть любым значением, отрицательным или положительным.
-Note that it is easy to efficiently make strings safe.  The example below shows how to terminate a garbage string:
+Заметим, что это легко и эффективно обезопасит строки. Пример ниже показывает, как предотвратить строки от мусора:
 <pawn>
 decl String:blah[512];