Merge pull request #339 from armed/master

[go/ru-ru] russian translation for Go language

1 files changed, 305 insertions, 0 deletions

diff --git a/ru-ru/go-ru.html.markdown b/ru-ru/go-ru.html.markdown
new file mode 100644
index 00000000..16193ec8
--- /dev/null
+++ b/ru-ru/go-ru.html.markdown
@@ -0,0 +1,305 @@
+---
+name: Go
+category: language
+language: Go
+filename: learngo-ru.go
+contributors:
+    - ["Sonia Keys", "https://github.com/soniakeys"]
+    - ["Artem Medeusheyev", "https://github.com/armed"]
+lang: ru-ru
+---
+
+Go - это язык общего назначения, целью которого является удобство, простота,
+конкуррентность. Это не тренд в компьютерных науках, а новейший и быстрый
+способ решать насущные проблемы.
+
+Концепции Go схожи с другими императивными статически типизированными языками.
+Быстро компилируются и быстро выполняются, имеет легкие в понимании конструкции
+для создания масштабируемых и многопоточных программ.
+
+Имеет в наличии отличную стандартную библиотеку и большое комьюнити, полное
+энтузиазтов.
+
+```go
+// Однострочный комментарий
+/* Многострочный
+   комментарий */
+
+// Ключевое слово package присутствует в начале каждого файла.
+// Main это специальное имя, обозначающее исполняемый файл, нежели библиотеку.
+package main
+
+// Import предназначен для указания зависимостей этого файла.
+import (
+    "fmt"      // Пакет в стандартной библиотеке Go
+    "net/http" // Да, это web server!
+    "strconv"  // Конвертирование типов в строки и обратно
+)
+
+// Объявление функции. Main это специальная функция, служащая точкой входа для
+// исполняемой программы. Нравится вам или нет, но Go использует фигурные
+// скобки.
+func main() {
+    // Println выводит строку в stdout.
+    // В данном случае фигурирует вызов функции из пакета fmt.
+    fmt.Println("Hello world!")
+
+    // Вызов другой функции из текущего пакета.
+    beyondHello()
+}
+
+// Функции содержат входные параметры в круглых скобках.
+// Если параметров нет, пустые скобки все равно обязательны.
+func beyondHello() {
+    var x int // Переменные должны быть объявлены до их использования.
+    x = 3     // Присвоение значения переменной.
+    // Краткое определение := позволяет объявить перменную с автоматической
+    // подстановкой типа из значения.
+    y := 4
+    sum, prod := learnMultiple(x, y)        // функция возвращает два значения
+    fmt.Println("sum:", sum, "prod:", prod) // простой вывод
+    learnTypes()                            // < y minutes, learn more!
+}
+
+// Функция имеющая входные параметры и возврат нескольких значений.
+func learnMultiple(x, y int) (sum, prod int) {
+    return x + y, x * y // возврат двух результатов
+}
+
+// Некотрые встроенные типы и литералы.
+func learnTypes() {
+    // Краткое определение переменной говорит само за себя.
+    s := "Learn Go!" // тип string
+
+    s2 := `"Чистый" строковой литерал
+может содержать переносы строк` // тоже тип данных string
+
+    // символ не из ASCII. Исходный код Go в кодировке UTF-8.
+    g := 'Σ' // тип rune, это алиас для типа uint32, содержит юникод символ
+
+    f := 3.14195 // float64, 64-х битное число с плавающей точкой (IEEE-754)
+    c := 3 + 4i  // complex128, внутри себя содержит два float64
+
+    // Синтаксис var с инициализациями
+    var u uint = 7 // беззнаковое, но размер зависит от реализации, как и у int
+    var pi float32 = 22. / 7
+
+    // Синтаксис приведения типа с кратким определением
+    n := byte('\n') // byte алиас для uint8
+
+    // Массивы (Array) имеют фиксированный размер на момент компиляции.
+    var a4 [4]int           // массив из 4-х int, проинициализирован нулями
+    a3 := [...]int{3, 1, 5} // массив из 3-х int, ручная инициализация
+
+    // Slice имеют динамическую длину. И массивы и slice-ы имеют каждый свои
+    // преимущества, но slice-ы используются гораздо чаще.
+    s3 := []int{4, 5, 9}    // по сравнению с a3 тут нет троеточия
+    s4 := make([]int, 4)    // выделение памяти для slice из 4-х int (нули)
+    var d2 [][]float64      // только объявление, память не выделяется
+    bs := []byte("a slice") // конвертирование строки в slice байтов
+
+    p, q := learnMemory() // объявление p и q как указателей на int.
+    fmt.Println(*p, *q)   // * извлекает указатель. Печатает два int-а.
+
+    // Map как словарь или хеш теблица из других языков является динамически
+    // растущим ассоциативным массивом.
+    m := map[string]int{"three": 3, "four": 4}
+    m["one"] = 1
+
+    // Неиспользуемые переменные в Go являются ошибкой.
+    // Нижнее подчеркивание позволяет игнорировать такие переменные.
+    _, _, _, _, _, _, _, _, _ = s2, g, f, u, pi, n, a3, s4, bs
+    // Вывод считается использованием переменной.
+    fmt.Println(s, c, a4, s3, d2, m)
+
+    learnFlowControl() // идем далее
+}
+
+// У Go есть полноценный сборщик мусора. В нем есть указатели но нет арифметики
+// указатеей. Вы можете допустить ошибку с указателем на nil, но не с его
+// инкрементацией.
+func learnMemory() (p, q *int) {
+    // Именованные возвращаемые значения p и q являются указателями на int.
+    p = new(int) // встроенная функция new выделяет память.
+    // Выделенный int проинициализирован нулем, p больше не содержит nil.
+    s := make([]int, 20) // Выделение единого блока памяти под 20 int-ов,
+    s[3] = 7             // назначение одному из них,
+    r := -2              // опредление еще одной локальной переменной,
+    return &s[3], &r     // амперсанд обозначает получение адреса переменной.
+}
+
+func expensiveComputation() int {
+    return 1e6
+}
+
+func learnFlowControl() {
+    // If-ы всегда требуют наличине фигурных скобок, но круглые скобки
+    // необязательны.
+    if true {
+        fmt.Println("told ya")
+    }
+    // Форматирование кода стандартизировано утилитой "go fmt".
+    if false {
+        // все тлен
+    } else {
+        // жизнь прекрасна
+    }
+    // Использоване switch на замену нескольким if-else
+    x := 1
+    switch x {
+    case 0:
+    case 1:
+        // case-ы в Go не проваливаются, т.е. break по умолчанию
+    case 2:
+        // не выполнится
+    }
+    // For, как и if не требует круглых скобок
+    for x := 0; x < 3; x++ { // ++ это операция
+        fmt.Println("итерация", x)
+    }
+    // тут x == 1.
+
+    // For это единственный цикл в Go, но у него несколько форм.
+    for { // бесконечный цикл
+        break    // не такой уж и бесконечный
+        continue // не выполнится
+    }
+    // Как и в for, := в if-е означает объявление и присвоение значения y,
+    // затем проверка y > x.
+    if y := expensiveComputation(); y > x {
+        x = y
+    }
+    // Функции являются замыканиями.
+    xBig := func() bool {
+        return x > 100 // ссылается на x, объявленый выше switch.
+    }
+    fmt.Println("xBig:", xBig()) // true (т.к. мы присвоили x = 1e6)
+    x /= 1e5                     // тут х == 10
+    fmt.Println("xBig:", xBig()) // теперь false
+
+    // Метки, куда же без них, их все любят.
+    goto love
+love:
+
+    learnInterfaces() // О! Интерфейсы, идем далее.
+}
+
+// Объявление Stringer как интерфейса с одним мметодом, String.
+type Stringer interface {
+    String() string
+}
+
+// Объявление pair как структуры с двумя полями x и y типа int.
+type pair struct {
+    x, y int
+}
+
+// Объявление метода для типа pair. Теперь pair реализует интерфейс Stringer.
+func (p pair) String() string { // p в данном случае называют receiver-ом
+    // Sprintf - еще одна функция из пакета fmt.
+    // Обращение к полям p через точку.
+    return fmt.Sprintf("(%d, %d)", p.x, p.y)
+}
+
+func learnInterfaces() {
+    // Синтаксис с фигурными скобками это "литерал структуры". Он возвращает
+    // проинициализированную структуру, а оператор := присваивает ее в p.
+    p := pair{3, 4}
+    fmt.Println(p.String()) // вызов метода String у p, типа pair.
+    var i Stringer          // объявление i как типа с интерфейсом Stringer.
+    i = p                   // валидно, т.к. pair реализует Stringer.
+    // Вызов метода String у i, типа Stringer. Вывод такой же что и выше.
+    fmt.Println(i.String())
+
+    // Функции в пакете fmt вызывают метод String у объектов для получения
+    // строкового представления о них.
+    fmt.Println(p) // Вывод такой же что и выше. Println вызывает метод String.
+    fmt.Println(i) // тоже самое
+
+    learnErrorHandling()
+}
+
+func learnErrorHandling() {
+    // Идиома ", ok" служит для обозначения сработало что-то или нет.
+    m := map[int]string{3: "three", 4: "four"}
+    if x, ok := m[1]; !ok { // ok будет false, потому что 1 нет в map-е.
+        fmt.Println("тут никого")
+    } else {
+        fmt.Print(x) // x содержал бы значение, если бы 1 был в map-е.
+    }
+    // Идиома ", err" служит для обозначения была ли ошибка или нет.
+    if _, err := strconv.Atoi("non-int"); err != nil { // _ игнорирует значение
+        // выведет "strconv.ParseInt: parsing "non-int": invalid syntax"
+        fmt.Println(err)
+    }
+    // Мы еще обратимся к интерфейсам чуть позже, а пока...
+    learnConcurrency()
+}
+
+// c это тип данных channel (канал), объект для конкуррентного взаимодействия.
+func inc(i int, c chan int) {
+    c <- i + 1 // когда channel слева, <- являтся оператором "отправки".
+}
+
+// Будем использовать функцию inc для конкуррентной инкрементации чисел.
+func learnConcurrency() {
+    // Тот же make, что и в случае со slice. Он предназначен для выделения
+    // памяти и инициализации типов slice, map и channel.
+    c := make(chan int)
+    // Старт трех конкуррентных goroutine. Числа будут инкрементированы
+    // конкуррентно и, может быть параллельно, если машина правильно
+    // сконфигурирована и позволяет это делать. Все они будут отправлены в один
+    // и тот же канал.
+    go inc(0, c) // go начинает новую горутину.
+    go inc(10, c)
+    go inc(-805, c)
+    // Считывание всех трех результатов из канала и вывоод на экран.
+    // Нет никакой гарантии в каком порядке они будут выведены.
+    fmt.Println(<-c, <-c, <-c) // канал справа, <- обозначает "получение".
+
+    cs := make(chan string)       // другой канал, содержит строки.
+    cc := make(chan chan string)  // канал каналов со строками.
+    go func() { c <- 84 }()       // пуск новой горутины для отправки значения
+    go func() { cs <- "wordy" }() // еще раз, теперь для cs
+    // Select тоже что и switch, но работает с каналами. Он случайно выбирает
+    // готовый для взаимодействия канал.
+    select {
+    case i := <-c: // полученное значение можно присвоить переменной
+        fmt.Printf("это %T", i)
+    case <-cs: // либо значение можно игнорировать
+        fmt.Println("это строка")
+    case <-cc: // пустой канал, не готов для коммуникации.
+        fmt.Println("это не выполнится.")
+    }
+    // В этой точке значение будет получено из c или cs. Одна горутина будет
+    // завершена, другая останется заблокированной.
+
+    learnWebProgramming() // Да, Go это может.
+}
+
+// Всего одна функция из пакета http запускает web-сервер.
+func learnWebProgramming() {
+    // У ListenAndServe первый параметр это TCP адрес, который нужно слушать.
+    // Второй параметр это интерфейс типа http.Handler.
+    err := http.ListenAndServe(":8080", pair{})
+    fmt.Println(err) // не игнорируйте сообщения об ошибках
+}
+
+// Реализация интерфейса http.Handler для pair, только один метод ServeHTTP.
+func (p pair) ServeHTTP(w http.ResponseWriter, r *http.Request) {
+    // Обработка запроса и отправка данных методом из http.ResponseWriter
+    w.Write([]byte("You learned Go in Y minutes!"))
+}
+```
+
+## Что еще почитать
+
+Основа всех основ в Go это [официальный веб сайт](http://golang.org/).
+Там можно пройти туториал, поиграться с интерактивной средой Go и почитать
+объемную документацию.
+
+Для ознакомления рекомендуется почитать исходные коды [стандартной библиотеки
+Go](http://golang.org/src/pkg/). Отлично задокументированая, она является
+лучшим источником для чтения и понимания Go, его стиля и идиом. Либо можно,
+кликнув на имени функции в [документации](http://golang.org/pkg/), перейти к ее
+исходным кодам.