Add Ukrainian translation of arrays (collections-2.13) #2502

mbvyn · 2022-08-21T13:03:30Z

No description provided.

andriibutko · 2022-08-21T13:22:42Z

_overviews/collections-2.13/arrays.md

@@ -8,7 +8,7 @@ num: 10
 previous-page: concrete-mutable-collection-classes
 next-page: strings

-languages: [ru]
+languages: [uk, ru]


Why uk and not ukr?

There's only ISO 639-1 code used, so we are also using it.

VladKopanev · 2022-08-22T07:06:04Z

_uk/overviews/collections-2.13/arrays.md

+languages: uk
+---
+
+[Масиви](https://www.scala-lang.org/api/{{ site.scala-version }}/scala/Array.html) є спеціальним типом колекцій в Scala. З однієї сторони, Scala масиви один в один відповідають масивам в Java. Наприклад, Scala масив `Array[Int]` представлений в Java, як `int[]`, а `Array[Double]` в Java виглядатиме, як`double[]` і `Array[String]` відповідатиме Java `String[]`. Але з іншої сторони, Scala масиви пропонують набагато більше, ніж Java аналоги. По-перше, Scala масиви можуть бути _узагальнені_. Наприклад ви можете мати `Array[T]`, де `T` - це параметр типу або ж абстрактний тип. По-друге, Scala масиви сумісні з Scala послідовностями (`Seq`), тобто ви можете передати на вхід `Array[T]` де вимагається `Seq[T]`. Врешті-решт, Scala масиви також підтримують усі операції, які можна зробити з послідовностями (`Seq`). Ось приклад цього на ділі:


якdouble[]

Пропущено пробіл

масиви сумісні з Scala

Милозвучніше буде написати "сумісні зі Scala"

VladKopanev · 2022-08-22T07:09:57Z

_uk/overviews/collections-2.13/arrays.md

+    scala> a3.reverse
+    res0: Array[Int] = Array(9, 3)
+
+Враховуючи те, що Scala масиви представленні, так само як в Java, яким чином ці додаткові можливості підтримуються в Scala? Реалізація Scala масивів систематично використовує неявні перетворення. В Scala, масив не пробує _вдавати_ послідовність. Насправді він і не може, тому що тип даних представлений у чистому масиві не є підтипом `Seq`. Замість цього відбувається неявне "обгортання", перетворення між масивами та екземпляром класу `scala.collection.mutable.ArraySeq`, який у свою чергу є підтипом `Seq`. Ось, як це працює:


масиви представленні

масиви представлені

масив не пробує

"не намагається" здається краще звучить, імхо

VladKopanev · 2022-08-22T07:13:57Z

_uk/overviews/collections-2.13/arrays.md

+    scala> a1 eq a4
+    res1: Boolean = false
+
+Приклад вище показує, що масиви сумісні з послідовностями, тому що відбувається неявне перетворення з масивів в `ArraySeq`. Щоб зробити зворотнє перетворення, з `ArraySeq` в `Array`, ви можете використати `toArray` метод, який визначений в `Iterable`. Останній REPL рядок вище показує, що обгортання, а потім розгортання за допомогою `toArray` створює копію оригінального масиву.


рядок вище показує

Я б замінив на "рядок вище демонструє", щоб не повторювати те саме висказування з початку абзацу де вже вживалося "Приклад вище показує"

VladKopanev · 2022-08-22T07:17:14Z

_uk/overviews/collections-2.13/arrays.md

+
+Приклад вище показує, що масиви сумісні з послідовностями, тому що відбувається неявне перетворення з масивів в `ArraySeq`. Щоб зробити зворотнє перетворення, з `ArraySeq` в `Array`, ви можете використати `toArray` метод, який визначений в `Iterable`. Останній REPL рядок вище показує, що обгортання, а потім розгортання за допомогою `toArray` створює копію оригінального масиву.
+
+Існує інше неявне перетворення, яке застосовується до масивів. Це перетворення просто "додає" усі методи послідовностей до масивів, але не перетворює самі масиви в послідовності. "Додання" означає, що масив є обгорнутий в інший об'єкт типу `ArrayOps`, який підтримує усі методи послідовностей. Зазвичай, цей `ArrayOps` об'єкт є недовговічний; він, як правило, буде недоступним після виклику метода послідовності і його зберігання може бути утилізоване. Новітні віртуальні машини часто уникають створення цього об'єкта повністю.


< Існує інше

"Icнує й інше"
Також краще звучить

VladKopanev · 2022-08-22T07:21:34Z

_uk/overviews/collections-2.13/arrays.md

+
+Ви можете побачити, що виклик метода `reverse` на `seq`, який має тип `ArraySeq`, знову верне тип `ArraySeq`. Це логічно, тому що `ArraySeq` є `Seq`, і виклик метода `reverse` на інших `Seq` знову вертатиме `Seq`. З іншої сторони, виклик `reverse` на об'єкті класу `ArrayOps` верне тип `Array`, а не `Seq`.
+
+Приклад `ArrayOps` вище був дещо штучний, лише для того, щоб показати різницю `ArraySeq`. Зазвичай ви ніколи не будете визначати об'єкт класу `ArrayOps`. Ви будете просто викликати `Seq` метод на масиві:


різницю ArraySeq

"різницю з ArraySeq"

визначати об'єкт класу ArrayOps

"створювати самі об'єкт класу ArrayOps"

VladKopanev · 2022-08-22T07:26:31Z

_uk/overviews/collections-2.13/arrays.md

+    scala> intArrayOps(a1).reverse
+    res5: Array[Int] = Array(3, 2, 1)
+
+де `intArrayOps` є неявним перетворенням, що було вставлене напередодні. Це викликає питання, як компілятор вибрав `intArrayOps` серед інших неявних перетворень `ArraySeq` в рядку вище. Зрештою, обидва перетворення змінять масив в тип підтримуючий метод `reverse`, що й вказано у вхідних даних. Відповідь на це питання полягає в тому, що два неявних перетворення мають пріоритет. Перетворення `ArrayOps` має більший пріорітет, ніж `ArraySeq`. Перший визначений в `Predef` об'єкті, а другий в класі `scala.LowPriorityImplicits`, який наслідується `Predef`. Неявне перетворення в підкласах та підоб'єктах мають перевагу над неявним перетворенням в базовому класі. То ж, якщо обидва перетворення застосовані, вибирається, той що в `Predef`. Дуже схожий підхід використовується в рядках (`String`).


що було вставлене напередодні

Краще "що було вставлене перед цим", для мене передодні чомусь звучить, як "учора"

kazanzhy · 2022-08-23T07:33:10Z

_uk/overviews/collections-2.13/arrays.md

+    scala> intArrayOps(a1).reverse
+    res5: Array[Int] = Array(3, 2, 1)
+
+де `intArrayOps` є неявним перетворенням, що було вставлене перед цим. Це викликає питання, як компілятор вибрав `intArrayOps` серед інших неявних перетворень `ArraySeq` в рядку вище. Зрештою, обидва перетворення змінять масив в тип підтримуючий метод `reverse`, що й вказано у вхідних даних. Відповідь на це питання полягає в тому, що два неявних перетворення мають пріоритет. Перетворення `ArrayOps` має більший пріорітет, ніж `ArraySeq`. Перший визначений в `Predef` об'єкті, а другий в класі `scala.LowPriorityImplicits`, який наслідується `Predef`. Неявне перетворення в підкласах та підоб'єктах мають перевагу над неявним перетворенням в базовому класі. То ж, якщо обидва перетворення застосовані, вибирається, той що в `Predef`. Дуже схожий підхід використовується в рядках (`String`).


Якось "...тип підтримуючий..." не звучить.
Може "тип, що підтриує" або "що реалізовує метод reverse"?

s/пріорітет/пріоритет

kazanzhy · 2022-08-23T07:37:02Z

_uk/overviews/collections-2.13/arrays.md

+      arr
+    }
+
+Метод `evenElems` повертає новий масив який складається з усіх елементів аргумента вектора `xs` які знаходяться на парних позиціях у векторі. Перший рядок тіла метода `evenElems` створює новий масив результатів, який має той самий тип елемента, що й аргумент. Отже, залежно від фактичного параметра типу `T`, це може бути `Array[Int]`, або `Array[Boolean]`, або масив інших примітивних типів в Java, або ж масив певного посилального типу. Але всі ці типи мають різне представлення під час виконання, тож як середовище виконання Scala вибере правильне? Насправді воно не може цього зробити на основі наданої інформації, оскільки фактичний тип, який відповідає параметру типу `T` стирається під час виконання. Ось чому ви отримаєте таке повідомлення про помилку, якщо скомпілюєте наведений вище код:


s/аргумента/аргументу

kazanzhy · 2022-08-23T07:37:54Z

_uk/overviews/collections-2.13/arrays.md

+      val arr = new Array[T]((arr.length + 1) / 2)
+                ^
+
+Тут потрібно, щоб ви допомогли компілятору, надавши деяку підказку під час виконання, яким є фактичний параметр типу `evenElems`. Ця підказка під час виконання має форму маніфесту типу класу `scala.reflect.ClassTag`. Маніфест класу - це об'єкт дескриптор типа, що описує, який тип у класа верхнього рівня. Як альтернатива маніфестам класу існують також повні маніфести типу `scala.reflect.Manifest`, які описують усі аспекти типу. Але для створення масиву потрібні лише маніфести класу.


s/класа/класу

_uk/overviews/collections-2.13/arrays.md

Co-authored-by: Dmytro Kazanzhy <[email protected]>

# Conflicts: # _uk/overviews/collections-2.13/arrays.md

Add Ukrainian translation of arrays (collections-2.13)

624aedd

andriibutko reviewed Aug 21, 2022

View reviewed changes

VladKopanev suggested changes Aug 22, 2022

View reviewed changes

mbvyn and others added 2 commits August 22, 2022 19:30

fix several bugs

7a11382

Fix another bug

6b11c21

VladKopanev approved these changes Aug 22, 2022

View reviewed changes

kazanzhy approved these changes Aug 23, 2022

View reviewed changes

mbvyn and others added 2 commits August 23, 2022 20:47

Fix other issues

9fe8397

Fix other issues

6c9e233

kazanzhy reviewed Sep 11, 2022

View reviewed changes

_uk/overviews/collections-2.13/arrays.md Outdated Show resolved Hide resolved

mbvyn and others added 3 commits September 11, 2022 15:14

Update _uk/overviews/collections-2.13/arrays.md

7fdc7fd

Co-authored-by: Dmytro Kazanzhy <[email protected]>

Remove temporarily unavailable links

870620b

Merge remote-tracking branch 'origin/main'

3acc26f

# Conflicts: # _uk/overviews/collections-2.13/arrays.md

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add Ukrainian translation of arrays (collections-2.13) #2502

Add Ukrainian translation of arrays (collections-2.13) #2502

mbvyn commented Aug 21, 2022

andriibutko Aug 21, 2022

kazanzhy Aug 23, 2022

VladKopanev Aug 22, 2022

VladKopanev Aug 22, 2022

VladKopanev Aug 22, 2022

VladKopanev Aug 22, 2022

VladKopanev Aug 22, 2022 •

edited

Loading

VladKopanev Aug 22, 2022

kazanzhy Aug 23, 2022 •

edited

Loading

kazanzhy Aug 23, 2022

kazanzhy Aug 23, 2022

kazanzhy Aug 23, 2022


		Приклад вище показує, що масиви сумісні з послідовностями, тому що відбувається неявне перетворення з масивів в `ArraySeq`. Щоб зробити зворотнє перетворення, з `ArraySeq` в `Array`, ви можете використати `toArray` метод, який визначений в `Iterable`. Останній REPL рядок вище показує, що обгортання, а потім розгортання за допомогою `toArray` створює копію оригінального масиву.

		Існує інше неявне перетворення, яке застосовується до масивів. Це перетворення просто "додає" усі методи послідовностей до масивів, але не перетворює самі масиви в послідовності. "Додання" означає, що масив є обгорнутий в інший об'єкт типу `ArrayOps`, який підтримує усі методи послідовностей. Зазвичай, цей `ArrayOps` об'єкт є недовговічний; він, як правило, буде недоступним після виклику метода послідовності і його зберігання може бути утилізоване. Новітні віртуальні машини часто уникають створення цього об'єкта повністю.


		Ви можете побачити, що виклик метода `reverse` на `seq`, який має тип `ArraySeq`, знову верне тип `ArraySeq`. Це логічно, тому що `ArraySeq` є `Seq`, і виклик метода `reverse` на інших `Seq` знову вертатиме `Seq`. З іншої сторони, виклик `reverse` на об'єкті класу `ArrayOps` верне тип `Array`, а не `Seq`.

		Приклад `ArrayOps` вище був дещо штучний, лише для того, щоб показати різницю `ArraySeq`. Зазвичай ви ніколи не будете визначати об'єкт класу `ArrayOps`. Ви будете просто викликати `Seq` метод на масиві:

Add Ukrainian translation of arrays (collections-2.13) #2502

Are you sure you want to change the base?

Add Ukrainian translation of arrays (collections-2.13) #2502

Conversation

mbvyn commented Aug 21, 2022

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

VladKopanev Aug 22, 2022 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

kazanzhy Aug 23, 2022 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

VladKopanev Aug 22, 2022 •

edited

Loading

kazanzhy Aug 23, 2022 •

edited

Loading