ITI0011RUS:занятие 02 - Redigeerimiste ajalugu

Aleksandr: /* git */

2015-02-06T20:15:47Z

git

Aleksandr – 6. veebruar 2015, kell 20:15

2015-02-06T20:15:10Z

Aleksandr: /* Функции */

2015-02-06T20:13:55Z

Функции

Aleksandr: /* Funktsioonide dokumenteerimine (JavaDoc) */

2015-02-06T20:13:19Z

Funktsioonide dokumenteerimine (JavaDoc)

Aleksandr: /* Funktsioonid */

2015-02-06T20:00:45Z

Funktsioonid

Aleksandr: /* = Jagamine, jääk */

2015-02-06T19:40:13Z

= Jagamine, jääk

Aleksandr: /* Operatsioonid, tehted */

2015-02-06T19:31:37Z

Operatsioonid, tehted

Aleksandr: /* Константы */

2015-02-06T19:29:27Z

Константы

Aleksandr: /* Константы */

2015-02-06T19:28:45Z

Константы

Aleksandr: /* Muutujad */

2015-02-06T19:25:00Z

Muutujad

Näita muudatusi

@@ 155. rida: / 155. rida: @@
 Для того чтобы запустить программу в меню в верхней части окна выберите Run -> Run As -> Java Application. Того же самого можно добиться комбинацией клавиш ctrl + F11. При запуске программы автоматически станет активным панель '''Консоль (Console)''', в которой должен появиться строка "Hello World!". Мы завершили написание первой Java программы, хотя мы многого не говорили о том, что каждая строчка кода означает. Продолжим ознакомление с языком Java.
-== git ==
+== Система контроля версий Git ==
-TODO
+TBA
 == Переменные ==

←Vanem redaktsioon		Redaktsioon: 6. veebruar 2015, kell 20:15
1. rida:		1. rida:
−		+	Вернуться [[ITI0011RUS\|на страницу предмета]]

	== Общая информация ==		== Общая информация ==

@@ 458. rida: / 458. rida: @@
 </source>
 === Документирование кода (JavaDoc) ===
 JavaDoc - программа которая может сгенерировать документацию к программе, используя для этого коментарии в коде.

@@ 458. rida: / 458. rida: @@
 </source>
-=== Funktsioonide dokumenteerimine (JavaDoc) ===
+=== Документирование кода (JavaDoc) ===
-JavaDoc on dokumentatsiooni genereerimise tööriist, mis kasutab kommentaare koodist, et genereerida dokumentatsioon ehk "juhend".
+JavaDoc - программа которая может сгенерировать документацию к программе, используя для этого коментарии в коде.
-Näiteks funktsiooni JavaDoc:
+Пример JavaDoc коментария в котором описана функция pythagoras (пример ниже):
 <source lang="java">
@@ 475. rida: / 475. rida: @@
 </source>
-JavaDoc funktsioonidele:
+JavaDoc коментарий к функции:
-* algab /** sümbolitega
+* начинается с символа /**
-* iga järgmie rida algab *-ga
+* каждая последующая строка начинается с символа *
-* esimene lause on lühike kokkuvõte.
+* первое предложение - краткое описание.
-* seejärel võib tulla mitu lauset (või isegi mitu lõiku) kirjeldust
+* после него может следовать несколько предложений (даже несколько параграфов) более детального описания
-* parameetrid kirjeldatakse ära @param sildiga: <code>@param [muutuja-nimi] [kirjeldus]</code>
+* значение парамеров обозначаются надписью @param: <code>@param [имя переменной] [описание]</code>
-* tagastusväärtus (kui see on olemas) kirjeldatakse @return sildiga: <code>@return [kirjeldus]</code>
+* возвращаемое значение (если оно есть) обозначается надписью @return: <code>@return [описание]</code>
-* silte on palju erinevaid lisaks nendele kahele mainitule
+* помимо вышеперечисленных двух надписей есть еще целое множество
-* lõppeb */ sümbolitega eraldi real
+* завершается символами */ в отдельной строке
-Rohkem informatsiooni: http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html
+Полее подробно вы сможете прочесть в документации: http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html

@@ 386. rida: / 386. rida: @@
 </source>
-== Funktsioonid ==
+== Функции ==
-Lühike sissejuhatus funktsioonidesse. Täpsemalt räägime järgmistes praktikumides.
+Небольшое вступление на тему функций. Более подробно обсудим эту тему на последующих занятиях.
-Programmi koodi saab jagada osadeks. Osa koosneb grupeeritud käskudest, millele antakse nimetus. Kui kuskil programmis on vastavaid käske vaja kasutada, saab välja kutsuda nimeliselt eelnevalt grupeeritud koodiosa.
+Часто в программах одно и то же действие повторяется несколько раз с незначительными вариациями. В основу функций заложен принцип повторного использования участков кода и их неоднократного использования. Код программы разделен на части, у каждой из которой свое имя. Каждая такая часть состоит из сгруппированных инструкций. Если где-то в коде возникает необходимость использовать эту группу инструкций, их можно запустить по имени этой группы.
-Funktsioonid jagunevad kaheks:
+Функции условно разделяются на два вида:
-* ühed, mis tagastavad mingi väärtuse (neid nimetatakse funktsioonideks)
+* те, что возвращают какое-то значение (их называют функциями, как в математике y = f(x))
-* teised, mis ei tagasta väärtust (neid nimetatakse vahel protseduurideks)
+* те, что не возвращают значений (их иногда называют процедурами)
-Tegelikult võib mõlemat tüüpi funktsiooni kohta öelda lihtsalt "funktsioon" või Javas ka "meetod". Seega, neid termineid kasutatakse segamini. Pigem sisu järgi saab vahet teha, mistüüpi funktsiooni/meetodiga tegemist on.
+Разделение на типы чисто условное - и те и другие можно называть просто "функциями", а в языке Java также и "методами" (метод - функция, находящаяся внутри класса). Эти термины используются повсеместно в литературе. Судить о том, возвращает функция значение или нет следует не по тому как ее называют - функция, метод, процедура - я по ее объявлению.
-Mõned näited matemaatilistest funktsioonidest:
+Некоторые примеры математических функций:
-* <code>Math.sqrt(x);</code> - tagastab etteantud argumendi ruutjuure
+* <code>Math.sqrt(x);</code> - возвращает квадратный корень переданного аргумента
-* <code>Math.random();</code> - tagastab juhusliku arvu vahemikus [0..1)
+* <code>Math.random();</code> - возвращает псевдослучайное число в промежутке [0..1)
-Funktsiooni defineerimine:
+Объявление функции:
-<pre>[laiendid] [tagastus-tüüp] [funktsiooni-nimi] ([parameetrite nimekiri]) {
+<pre>[префиксы] [возвращаемый тип данных] [тия функции] ([параметры]) {
-	[käsud]
+	[инструкции]
+}
 </pre>
-Laiendeid võib olla mitu või võivad üldse puududa. Need on peamiselt olulised siis, kui hakkame objekt-orienteeritud koodi kirjutama.
+Префиксов может быть несклько (например, <code>public static</code>, но префиксы могут и отсутствовать совсем. Префиксы станут важны тогда, когда мы начнем писать объектно-ориентированный код.
-Parameetrite nimekiri on komaga eraldatud argumentide nimed koos tüübiga. Kui funktsioon välja kutsutakse, tuleb sellised argumendid kaasa anda. Oluline on, et kaasaantud argumentide tüübid oleksid täpselt samad, nagu funktsioon eeldab. Funktsiooni sees on parameetrid nagu deklareeritud muutujad. Alloleva näite puhul deklareeritakse double-tüüpi muutuja x ja y, mille väärtus määratakse sellel hetkel, kui funktsioon väja kutsutakse. Kogu funktsiooni ulatuses {} märkide vahel on need funktsioonid kättesaadavad.
+Параметры функции представляют собой разделенный запятыми список типов данных аргументов и их имен. Параметры функции передаются ей при вызове. Важно передавать функции параметры тех типов данных, которые она ожидает получить. Внутри функции параметры можно воспринимать как объявленные и проинициализированные соответствующими значениями переменные. В примере ниже функция принимает два параметра типа double. Мы можем думать об этих параметрах просто как о переменых с именами x и y, значения которых присвоится переменным в момент вызова функции. Эти переменные видны и доступны на всем протяжении тела функции (тело функции - код, который находится между фигурными скобками {}).
-Funktsioon, millel on määratud tagastusväärtus (allpool olev funktsioon tagastab boolean väärtuse), saab seda teha käsuga:
+Если функция не возвращает никаких значений, то ее возвращаемый тип данных - '''void'''.
-<code>return [avaldis];</code>
+Если возвращаемый тип данных нечто отличное от void, такая функция обязана вернуть значение. В теле такой функции должна содержаться инструкция:
-Funktsioon lõpetab oma töö ära peale "return" käsku.
+<code>return [выражение или значение];</code>
 <source lang="java">
 public static boolean lessThan(double x, double y) {
@@ 425. rida: / 428. rida: @@
 </source>
-Hiljem koodis saab sellise koodi asemel:
+Позже в коде следующие строки кода:
 <source lang="java">
@@ 435. rida: / 438. rida: @@
 </source>
-kirjutada nii:
+можно заменить вызовом функции lessThan:
 <source lang="java">
@@ 442. rida: / 445. rida: @@
 </source>
-Return käske võib funktsioonis olla mitu. See võib esineda ükskõik kus (ei pea funktsiooni lõpus olema). Täpselt üks return käsk käivitatakse, et funktsiooni väärtus tagastada (kuna peale esimese käivitamist lõpetab funktsioon oma töö, teise käsuni ei jõuta).
+В функции может быть несклько инструкций return и они могут располагаться где угодно в теле функции. При этом в ходе работы функции выполняется только одна инструкция return, по которой функция возвращает значение и завершается. Поскольку функция завершается при первом вызове return, то до следующего вызова return она никогда не доберется.
 <source lang="java">
 static intnextN(int currentN) {
@@ 450. rida: / 454. rida: @@
 		return 3 * currentN + 1; // if so, return this value
 	else
-		return currentN/ 2; // if not, return this instead
+		return currentN / 2; // if not, return this instead
+}
 </source>

@@ 339. rida: / 339. rida: @@
 * <code>x = (2 + 3) * 6;</code>
-==== Jagamine, jääk ===
+=== Деление, остаток ===
-Kui argumendid on täisarvud, on ka tulemus täisarv (võetakse täisosa, mitte ei ümardata):
+Если мы делим два целых числа, в результате также получим тоже целое число (результат не округляется - берется целая часть результата, дробная часть теряется) - это называется '''целочисленным делением (integer division)''':
 * 6 / 5 = 1
 * 3 / 5 = 0
 * 10 / 5 = 2
-Kui vähemalt üks argumentidest on komaga arv, on tulemus ka komaga arv:
+Если хотя бы один из аргументов ялвяется дробным числом, результат деления также является дробным числом:
 * 6.0 / 5 = 1.2
 * 3 / 5.0 = 0.6
 * 10.0 / 5.0 = 2.0
-Jääk jagamisel (%):
+Остаток от деления (%):
-* 22 % 5 = 2 (22 / 5 on 4, jääk on 2)
+* 22 % 5 = 2 (22 / 5 это 4 с остатком 2)
 * 5 % 5 = 0
 * 3 % 5 = 3
-Jäägist võib mõelda nii, et kui meil on 22 õuna ja peame need 5 inimese vahel jagama (õunu katki ei tohi teha), siis mitu õuna jääb üle. Või kui meil on 3 õuna, siis 5-le inimesele jagatuna saab igaüks 0, 3 jääb üle.
+Пусть у нас есть 22 яблока которые нужно разделить на 5 человек (яблоки разрезать на части нельзя). Сколько яблок останется? Если у нас 3 яблока, то если разделить их между 5 людбми каждый получит 0 яблок, и 3 яблока останется.
-==== Cast'imine ====
+==== Преобразование типов данных ====
-Kui muutujat on vaja kasutada teise andmetüübina, võib kasutada cast'imist. Näiteks täisarvude puhul saab kasutada, et saada "normaalne" tulemus.
+Иногда бывают ситуации, когда нужно использовать переменную определенного типа как переменную другого типа. В этом случае используется преобразование типа переменной.
-Cast'imine ei muuda muutuja väärtust.
+Пусть у нас даны две целочисленные переменные:
-Cast'imise süntaks:
+* <code>x = 8; y = 5;</code> (aga tahaksime saada 1.6)
-<code>([uus-tüüp])[muutuja-nimi-või-väärtus];</code>
+Если мы поделим их друг на друга, то результат будет 1:
-Näide:
+* <code>x / y = 1</code>
 <source lang="java">
 (double)8/5;  // => 1.6

@@ 318. rida: / 318. rida: @@
 О константах поговорим более детально немного позже. В данном контексте константы упомянуты из-за правил их наименования.
-=== Operatsioonid, tehted ===
+=== Операторы и действия с переменными ===
 [[Pilt:ITI0011-prax-02-operators.png]]
-Muutuja suurendamine/vähendamine ühe võrra:
+Увеличение/уменьшение значения переменной численного типа на единицу:
-* <code>y = x++</code> (x suurendatakse '''peale''' omistamist)
+* <code>y = x++</code> (увеличиваем значение x '''после''' взятия значения)
 ** y = x
 ** x = x + 1
-* <code>y = ++x</code> (x suurendatakse '''enne''' omistamist)
+* <code>y = ++x</code> (увеличиваем значение x '''до''' взятия значения)
 ** x = x + 1
 ** y = x
@@ 334. rida: / 334. rida: @@
 ** <code>x = x + y</code>
-Tehete järjekord (mis vastus on?):
+Последовательность действий (какое значение будет содержать переменная х?):
 * <code>x = 2 + 3 * 6;</code>

@@ 311. rida: / 311. rida: @@
 Константы объявляются в заголовке класса (перед объявлением методов/функций):
 <code>
 public static final double PI = 3.14;

@@ 306. rida: / 306. rida: @@
 === Константы ===
-Konstandid on erilisttüüpi muutujad. Nad on samamoodi andmetüübiga ja nimega viited mingile väärtusele. Erinevus tavalisest muutujast on see, et konstandi väärtust ei saa hiljem enam muuta. Konstandi nimetamise reelgid on mõnevõrra erinevad tavamuutujast:
+Константы - особые переменные, которые отличаются от обычных переменных тем, что значение константе присваивается сразу при ее инициализации и значение константы неизменно на всем протяжении ее существования. Правила, которые действуют в отношении имен констант также слегка отличаются от правил для имен переменных:
-* kõik tähed nimes on suurtähed: PI, SPEED.
+* все буквы в названии заглавные: PI, SPEED.
-* sõnad on eristatud alakriipsuga (_): SPEED_OF_LIGHT, NUMBER_OF_GEARS.
+* слова разделены символом подчеркивания (_): SPEED_OF_LIGHT, NUMBER_OF_GEARS.
-Konstandi saab luua klassi päises (enne meetodeid/funktsioone):
+Константы объявляются в заголовке класса (перед объявлением методов/функций):
 <code>
 public static final double PI = 3.14;
 </code>
-Aga konstantidest räägime täpsemalt mõnevõrra hiljem. Praeguses tekstis on konstandid mainitud nimetamise tõttu.
+О константах поговорим более детально немного позже. В данном контексте константы упомянуты из-за правил их наименования.
 === Operatsioonid, tehted ===