summaryrefslogtreecommitdiffhomepage
path: root/ru-ru
diff options
context:
space:
mode:
authorQumeric <qumidium@gmail.com>2014-04-16 18:06:58 +0400
committerQumeric <qumidium@gmail.com>2014-04-16 18:06:58 +0400
commit07b229a425d9181810b947c5c9380f7a48fe64ba (patch)
treeca4b19ae32df8f6786d2e7bfe1fc00a4b2da058a /ru-ru
parentb2a47cf123398b0053b031c7a9f1e34650585c1d (diff)
Fix Go tutorial, especially ru translation
Diffstat (limited to 'ru-ru')
-rw-r--r--ru-ru/go-ru.html.markdown170
1 files changed, 100 insertions, 70 deletions
diff --git a/ru-ru/go-ru.html.markdown b/ru-ru/go-ru.html.markdown
index e9892952..a4f9fd4a 100644
--- a/ru-ru/go-ru.html.markdown
+++ b/ru-ru/go-ru.html.markdown
@@ -3,8 +3,12 @@ language: Go
filename: learngo-ru.go
contributors:
- ["Sonia Keys", "https://github.com/soniakeys"]
+ - ["Christopher Bess", "https://github.com/cbess"]
+ - ["Jesse Johnson", "https://github.com/holocronweaver"]
+ - ["Quint Guvernator", "https://github.com/qguv"]
translators:
- ["Artem Medeusheyev", "https://github.com/armed"]
+ - ["Valery Cherepanov", "https://github.com/qumeric"]
lang: ru-ru
---
@@ -31,8 +35,9 @@ package main
// Import предназначен для указания зависимостей этого файла.
import (
"fmt" // Пакет в стандартной библиотеке Go
- "net/http" // Да, это web server!
+ "net/http" // Да, это веб-сервер!
"strconv" // Конвертирование типов в строки и обратно
+ m "math" // Импортировать math под локальным именем m.
)
// Объявление функции. Main это специальная функция, служащая точкой входа для
@@ -40,7 +45,7 @@ import (
// скобки.
func main() {
// Println выводит строку в stdout.
- // В данном случае фигурирует вызов функции из пакета fmt.
+ // Данная функция находится в пакете fmt.
fmt.Println("Hello world!")
// Вызов другой функции из текущего пакета.
@@ -55,57 +60,57 @@ func beyondHello() {
// Краткое определение := позволяет объявить перменную с автоматической
// подстановкой типа из значения.
y := 4
- sum, prod := learnMultiple(x, y) // функция возвращает два значения
- fmt.Println("sum:", sum, "prod:", prod) // простой вывод
+ 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 // возврат двух результатов
+ return x + y, x * y // Возврат двух значений.
}
// Некотрые встроенные типы и литералы.
func learnTypes() {
// Краткое определение переменной говорит само за себя.
- s := "Learn Go!" // тип string
+ s := "Learn Go!" // Тип string.
s2 := `"Чистый" строковой литерал
-может содержать переносы строк` // тоже тип данных string
+может содержать переносы строк` // Тоже тип данных string
- // символ не из ASCII. Исходный код Go в кодировке UTF-8.
- g := 'Σ' // тип rune, это алиас для типа uint32, содержит юникод символ
+ // Символ не из ASCII. Исходный код Go в кодировке UTF-8.
+ g := 'Σ' // тип rune, это алиас для типа uint32, содержит символ юникода.
- f := 3.14195 // float64, 64-х битное число с плавающей точкой (IEEE-754)
- c := 3 + 4i // complex128, внутри себя содержит два float64
+ f := 3.14195 // float64, 64-х битное число с плавающей точкой (IEEE-754).
+ c := 3 + 4i // complex128, внутри себя содержит два float64.
- // Синтаксис var с инициализациями
- var u uint = 7 // беззнаковое, но размер зависит от реализации, как и у int
+ // Синтаксис var с инициализациями.
+ var u uint = 7 // Беззнаковое, но размер зависит от реализации, как и у int.
var pi float32 = 22. / 7
// Синтаксис приведения типа с кратким определением
- n := byte('\n') // byte алиас для uint8
+ n := byte('\n') // byte – это алиас для uint8.
- // Массивы (Array) имеют фиксированный размер на момент компиляции.
- var a4 [4]int // массив из 4-х int, проинициализирован нулями
- a3 := [...]int{3, 1, 5} // массив из 3-х int, ручная инициализация
+ // Массивы имеют фиксированный размер на момент компиляции.
+ 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 байтов
+ // Слайсы (slices) имеют динамическую длину. И массивы, и слайсы имеют свои
+ // преимущества, но слайсы используются гораздо чаще.
+ s3 := []int{4, 5, 9} // Сравните с a3. Тут нет троеточия.
+ s4 := make([]int, 4) // Выделение памяти для слайса из 4-х int (нули).
+ var d2 [][]float64 // Только объявление, память не выделяется.
+ bs := []byte("a slice") // Синтаксис приведения типов.
- p, q := learnMemory() // объявление p и q как указателей на int.
+ p, q := learnMemory() // Объявление p и q как указателей на int.
fmt.Println(*p, *q) // * извлекает указатель. Печатает два int-а.
- // Map как словарь или хеш теблица из других языков является ассоциативным
- // массивом с динамически изменяемым размером.
+ // Map, также как и словарь или хеш из некоторых других языков, является
+ // ассоциативным массивом с динамически изменяемым размером.
m := map[string]int{"three": 3, "four": 4}
m["one"] = 1
- delete(m, "three") // встроенная функция, удаляет элемент из map-а.
+ delete(m, "three") // Встроенная функция, удаляет элемент из map-а.
// Неиспользуемые переменные в Go являются ошибкой.
// Нижнее подчеркивание позволяет игнорировать такие переменные.
@@ -113,79 +118,91 @@ func learnTypes() {
// Вывод считается использованием переменной.
fmt.Println(s, c, a4, s3, d2, m)
- learnFlowControl() // идем далее
+ learnFlowControl() // Идем дальше.
}
// У Go есть полноценный сборщик мусора. В нем есть указатели но нет арифметики
-// указатеей. Вы можете допустить ошибку с указателем на nil, но не с его
-// инкрементацией.
+// указатеей. Вы можете допустить ошибку с указателем на nil, но не с
+// инкрементацией указателя.
func learnMemory() (p, q *int) {
// Именованные возвращаемые значения p и q являются указателями на int.
- p = new(int) // встроенная функция new выделяет память.
+ p = new(int) // Встроенная функция new выделяет память.
// Выделенный int проинициализирован нулем, p больше не содержит nil.
- s := make([]int, 20) // Выделение единого блока памяти под 20 int-ов,
- s[3] = 7 // назначение одному из них,
- r := -2 // опредление еще одной локальной переменной,
- return &s[3], &r // амперсанд обозначает получение адреса переменной.
+ s := make([]int, 20) // Выделение единого блока памяти под 20 int-ов.
+ s[3] = 7 // Присвоить значение одному из них.
+ r := -2 // Опредление еще одну локальную переменную.
+ return &s[3], &r // Амперсанд(&) обозначает получение адреса переменной.
}
-func expensiveComputation() int {
- return 1e6
+func expensiveComputation() float64 {
+ return m.Exp(10)
}
func learnFlowControl() {
- // If-ы всегда требуют наличине фигурных скобок, но круглые скобки
- // необязательны.
+ // If-ы всегда требуют наличине фигурных скобок, но не круглых.
if true {
fmt.Println("told ya")
}
// Форматирование кода стандартизировано утилитой "go fmt".
if false {
- // все тлен
+ // Будущего нет.
} else {
- // жизнь прекрасна
+ // Жизнь прекрасна.
}
- // Использоване switch на замену нескольким if-else
- x := 1
+ // Используйте switch вместо нескольких if-else.
+ x := 42.0
switch x {
case 0:
case 1:
- // case-ы в Go не проваливаются, т.е. break по умолчанию
- case 2:
- // не выполнится
+ case 42:
+ // Case-ы в Go не "проваливаются" (неявный break).
+ case 43:
+ // Не выполнится.
}
// For, как и if не требует круглых скобок
- for x := 0; x < 3; x++ { // ++ это операция
+ // Переменные, объявленные в for и if являются локальными.
+ for x := 0; x < 3; x++ { // ++ – это операция.
fmt.Println("итерация", x)
}
- // тут x == 1.
+ // Здесь x == 42.
- // For это единственный цикл в Go, но у него несколько форм.
- for { // бесконечный цикл
- break // не такой уж и бесконечный
- continue // не выполнится
+ // For – это единственный цикл в Go, но у него есть альтернативные формы.
+ for { // Бесконечный цикл.
+ break // Не такой уж и бесконечный.
+ continue // Не выполнится.
}
// Как и в for, := в if-е означает объявление и присвоение значения y,
- // затем проверка y > x.
+ // проверка y > x происходит после.
if y := expensiveComputation(); y > x {
x = y
}
// Функции являются замыканиями.
xBig := func() bool {
- return x > 100 // ссылается на x, объявленый выше switch.
+ return x > 10000 // Ссылается на x, объявленый выше switch.
}
- fmt.Println("xBig:", xBig()) // true (т.к. мы присвоили x = 1e6)
- x /= 1e5 // тут х == 10
- fmt.Println("xBig:", xBig()) // теперь false
+ fmt.Println("xBig:", xBig()) // true (т.к. мы присвоили x = e^10).
+ x = 1.3e3 // Тут х == 1300
+ fmt.Println("xBig:", xBig()) // Теперь false.
// Метки, куда же без них, их все любят.
goto love
love:
+ learnDefer() // Быстрый обзор важного ключевого слова.
learnInterfaces() // О! Интерфейсы, идем далее.
}
-// Объявление Stringer как интерфейса с одним мметодом, String.
+func learnDefer() (ok bool) {
+ // Отложенные(deferred) выражения выполняются сразу перед тем, как функция
+ // возвратит значение.
+ defer fmt.Println("deferred statements execute in reverse (LIFO) order.")
+ defer fmt.Println("\nThis line is being printed first because")
+ // defer широко используется для закрытия файлов, чтобы закрывающая файл
+ // функция находилась близко к открывающей.
+ return true
+}
+
+// Объявление Stringer как интерфейса с одним методом, String.
type Stringer interface {
String() string
}
@@ -196,35 +213,48 @@ type pair struct {
}
// Объявление метода для типа pair. Теперь pair реализует интерфейс Stringer.
-func (p pair) String() string { // p в данном случае называют receiver-ом
- // Sprintf - еще одна функция из пакета fmt.
+func (p pair) String() string { // p в данном случае называют receiver-ом.
+ // Sprintf – еще одна функция из пакета fmt.
// Обращение к полям p через точку.
return fmt.Sprintf("(%d, %d)", p.x, p.y)
}
func learnInterfaces() {
// Синтаксис с фигурными скобками это "литерал структуры". Он возвращает
- // проинициализированную структуру, а оператор := присваивает ее в p.
+ // проинициализированную структуру, а оператор := присваивает её 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(p.String()) // Вызов метода String у p.
+ 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) // тоже самое
+ fmt.Println(p) // Вывод такой же, что и выше. Println вызывает метод String.
+ fmt.Println(i) // Вывод такой же, что и выше.
+
+ learnVariadicParams("Учиться", "учиться", "и еще раз учиться!")
+}
+
+// Функции могут иметь варьируемое количество параметров.
+func learnVariadicParams(myStrings ...interface{}) {
+ // Вывести все параметры с помощью итерации.
+ for _, param := range myStrings {
+ fmt.Println("param:", param)
+ }
+
+ // Передать все варьируемые параметры.
+ fmt.Println("params:", fmt.Sprintln(myStrings...))
learnErrorHandling()
}
func learnErrorHandling() {
- // Идиома ", ok" служит для обозначения сработало что-то или нет.
+ // Идиома ", ok" служит для обозначения корректного срабатывания чего-либо.
m := map[int]string{3: "three", 4: "four"}
if x, ok := m[1]; !ok { // ok будет false, потому что 1 нет в map-е.
- fmt.Println("тут никого")
+ fmt.Println("тут никого нет")
} else {
fmt.Print(x) // x содержал бы значение, если бы 1 был в map-е.
}
@@ -237,7 +267,7 @@ func learnErrorHandling() {
learnConcurrency()
}
-// c это тип данных channel (канал), объект для конкуррентного взаимодействия.
+// c – это тип данных channel (канал), объект для конкуррентного взаимодействия.
func inc(i int, c chan int) {
c <- i + 1 // когда channel слева, <- являтся оператором "отправки".
}