Merge pull request #115 from Abdelrahmansherwida/master

Array Methods Tasks

Author: OmarioHassan

1-js/05-data-types/05-array-methods/1-camelcase/task.md

@@ -2,18 +2,20 @@ importance: 5
 
 ---
 
-# Translate border-left-width to borderLeftWidth
+# Tحوّل «border-left-width» إلى «borderLeftWidth»
 
-Write the function `camelize(str)` that changes dash-separated words like "my-short-string" into camel-cased "myShortString".
+اكتب دالة camelize(str)‎ تغيّر الكلمات المقسومة بِشَرطات مثل «my-short-string» إلى عبارات بتنسيق «سنام الجمل»: «myShortString».
 
-That is: removes all dashes, each word after dash becomes uppercased.
+بعبارة أخرى: أزِل كلّ الشرطات وحوّل أوّل حرف من كلّ كلمة بعدها إلى الحالة الكبيرة.
 
-Examples:
+أمثلة:
+
+:
 
 ```js
-camelize("background-color") == 'backgroundColor';
-camelize("list-style-image") == 'listStyleImage';
-camelize("-webkit-transition") == 'WebkitTransition';
+camelize("background-color") == "backgroundColor";
+camelize("list-style-image") == "listStyleImage";
+camelize("-webkit-transition") == "WebkitTransition";
 ```
 
-P.S. Hint: use `split` to split the string into an array, transform it and `join` back.
+تلميح: استعمل split لتقسيم السلسلة النصية إلى مصفوفة، ثمّ عدّل عناصرها وأعِد ربطها بتابِع join.

1-js/05-data-types/05-array-methods/10-average-age/task.md

@@ -2,20 +2,20 @@ importance: 4
 
 ---
 
-# Get average age
+# ما متوسّط الأعمار؟
 
-Write the function `getAverageAge(users)` that gets an array of objects with property `age` and returns the average age.
+اكتب دالة getAverageAge(users)‎ تأخذ مصفوفة من كائنات لها الصفة age وتُعيد متوسّط الأعمار.
 
-The formula for the average is `(age1 + age2 + ... + ageN) / N`.
+معادلة المتوسّط: ‎(age1 + age2 + ... + ageN) / N.
 
-For instance:
+مثال:
 
 ```js no-beautify
 let john = { name: "John", age: 25 };
 let pete = { name: "Pete", age: 30 };
 let mary = { name: "Mary", age: 29 };
 
-let arr = [ john, pete, mary ];
+let arr = [john, pete, mary];
 
-alert( getAverageAge(arr) ); // (25 + 30 + 29) / 3 = 28
+alert(getAverageAge(arr)); // (25 + 30 + 29) / 3 = 28
 ```

1-js/05-data-types/05-array-methods/11-array-unique/solution.md

@@ -1,6 +1,7 @@
-Let's walk the array items:
-- For each item we'll check if the resulting array already has that item.
-- If it is so, then ignore, otherwise add to results.
+ما سنفعل هو المرور على عناصر المصفوفة:
+
+- سنفحص كلّ عنصر ونرى إن كان في المصفوفة الناتجة.
+- إن كان كذلك… نُهمله، وإن لم يكن، نُضيفه إلى المصفوفة.
 
 ```js run demo
 function unique(arr) {
@@ -15,25 +16,23 @@ function unique(arr) {
   return result;
 }
 
-let strings = ["Hare", "Krishna", "Hare", "Krishna",
-  "Krishna", "Krishna", "Hare", "Hare", ":-O"
+let strings = [
+  "Hare",
+  "Krishna",
+  "Hare",
+  "Krishna",
+  "Krishna",
+  "Krishna",
+  "Hare",
+  "Hare",
+  ":-O"
 ];
 
-alert( unique(strings) ); // Hare, Krishna, :-O
+alert(unique(strings)); // Hare, Krishna, :-O
 ```
 
-The code works, but there's a potential performance problem in it.
-
-The method `result.includes(str)` internally walks the array `result` and compares each element against `str` to find the match.
-
-So if there are `100` elements in `result` and no one matches `str`, then it will walk the whole `result` and do exactly `100` comparisons. And if `result` is large, like `10000`, then there would be `10000` comparisons.
-
-That's not a problem by itself, because JavaScript engines are very fast, so walk `10000` array is a matter of microseconds.
-
-But we do such test for each element of `arr`, in the `for` loop.
-
-So if `arr.length` is `10000` we'll have something like `10000*10000` = 100 millions of comparisons. That's a lot.
+صحيح أنّ الكود يعمل، إلّا أنّ فيه مشكلة أداء محتملة. خلف الكواليس، يمرّ التابِع result.includes(str)‎ على المصفوفة result ويقارن كلّ عنصر مع str ليجد المطابقة المنشودة. لذا لو كان في result مئة 100 عنصر وما من أيّ مطابقة مع str، فعليها المرور على جُلّ result وإجراء 100 حالة مقارنة كاملة. ولو كانت result كبيرة مثل 10000 فيعني ذلك 10000 حالة مقارنة.
 
-So the solution is only good for small arrays.
+إلى هنا لا مشكلة، لأنّ محرّكات جافاسكربت سريعة جدًا، والمرور على 1000 عنصر في المصفوفة يحدث في بضعة ميكروثوان. ولكنّا هنا في حلقة for نُجري هذه الشروط لكلّ عنصر من arr. فإن كانت arr.length تساوي 10000 فيعني أنّا سنُجري 10000\*10000 = مئة مليون حالة مقارنة. كثير جدًا.
 
-Further in the chapter <info:map-set> we'll see how to optimize it.
+إذًا، فهذا الحل ينفع للمصفوفات الصغيرة فقط. سنرى لاحقًا في الفصل كيف نحسّن هذا الكود

1-js/05-data-types/05-array-methods/11-array-unique/task.md

@@ -2,22 +2,28 @@ importance: 4
 
 ---
 
-# Filter unique array members
+# ترشيح العناصر الفريدة في المصفوفة
 
-Let `arr` be an array.
+لمّا أنّ arr مصفوفة، أنشِئ دالة unique(arr)‎ تُعيد مصفوفة فيها عناصر arr غير مكرّرة.
 
-Create a function `unique(arr)` that should return an array with unique items of `arr`.
-
-For instance:
+مثال:
 
 ```js
 function unique(arr) {
   /* your code */
 }
 
-let strings = ["Hare", "Krishna", "Hare", "Krishna",
-  "Krishna", "Krishna", "Hare", "Hare", ":-O"
+let strings = [
+  "Hare",
+  "Krishna",
+  "Hare",
+  "Krishna",
+  "Krishna",
+  "Krishna",
+  "Hare",
+  "Hare",
+  ":-O"
 ];
 
-alert( unique(strings) ); // Hare, Krishna, :-O
+alert(unique(strings)); // Hare, Krishna, :-O
 ```

1-js/05-data-types/05-array-methods/12-reduce-object/task.md

@@ -2,19 +2,19 @@ importance: 4
 
 ---
 
-# Create keyed object from array
+# انشاء مفاتيح خاصة بكائنات المصفوفة
 
-Let's say we received an array of users in the form `{id:..., name:..., age... }`.
+دعنا نقول أننا نستقبل مصفوفة خاصة بالمستخدمين داخل form مكونة `{id:..., name:..., age... }`
 
-Create a function `groupById(arr)` that creates an object from it, with `id` as the key, and array items as values.
+اكتب دالة `groupById(arr)` لانشاء كائن منها يحتوى على `id` كمفتاح و عناصر المصفوفة كقيم
 
-For example:
+مثال :
 
 ```js
 let users = [
-  {id: 'john', name: "John Smith", age: 20},
-  {id: 'ann', name: "Ann Smith", age: 24},
-  {id: 'pete', name: "Pete Peterson", age: 31},
+  { id: "john", name: "John Smith", age: 20 },
+  { id: "ann", name: "Ann Smith", age: 24 },
+  { id: "pete", name: "Pete Peterson", age: 31 }
 ];
 
 let usersById = groupById(users);
@@ -30,8 +30,8 @@ usersById = {
 */
 ```
 
-Such function is really handy when working with server data.
+هذه الوظيفة مفيدة حقًا عند العمل مع بيانات الخادم.
 
-In this task we assume that `id` is unique. There may be no two array items with the same `id`.
+في هذه المهمة نفترض أن `id` فريد. قد لا يكون هناك عنصران للصفيف بنفس "المعرف".
 
-Please use array `.reduce` method in the solution.
+يُرجى استخدام طريقة الصفيف `.reduce` في الحل.

1-js/05-data-types/05-array-methods/2-filter-range/task.md

@@ -2,21 +2,18 @@ importance: 4
 
 ---
 
-# Filter range
+# نطاق ترشيح
 
-Write a function `filterRange(arr, a, b)` that gets an array `arr`, looks for elements between `a` and `b` in it and returns an array of them. 
+اكتب دالة filterRange(arr, a, b)‎ تأخذ المصفوفة arr، وتبحث في عناصرها بين a وb وتُعيد مصفوفة بها. يجب ألّا تُعدّل الدالة المصفوفة، بل إعادة مصفوفة جديدة.
 
-The function should not modify the array. It should return the new array.
-
-For instance:
+مثال:
 
 ```js
 let arr = [5, 3, 8, 1];
 
-let filtered = filterRange(arr, 1, 4); 
+let filtered = filterRange(arr, 1, 4);
 
-alert( filtered ); // 3,1 (matching values)
+alert(filtered); // 3,1 (matching values)
 
-alert( arr ); // 5,3,8,1 (not modified)
+alert(arr); // 5,3,8,1 (not modified)
 ```
-

1-js/05-data-types/05-array-methods/3-filter-range-in-place/task.md

@@ -2,17 +2,18 @@ importance: 4
 
 ---
 
-# Filter range "in place"
+# نطاق ترشيح «كما هو»
 
-Write a function `filterRangeInPlace(arr, a, b)` that gets an array `arr` and removes from it all values except those that are between `a` and `b`. The test is: `a ≤ arr[i] ≤ b`.
+اكتب دالة filterRangeInPlace(arr, a, b)‎ تأخذ المصفوفة arr وتُزيل منها كل القيم عدا تلك بين a وb. الشرط هو: ‎a ≤ arr ≤ b.
 
-The function should only modify the array. It should not return anything.
+يجب أن تُعدّل الدالة المصفوفة، ولا تُعيد شيئًا.
+
+مثال:
 
-For instance:
 ```js
 let arr = [5, 3, 8, 1];
 
 filterRangeInPlace(arr, 1, 4); // removed the numbers except from 1 to 4
 
-alert( arr ); // [3, 1]
+alert(arr); // [3, 1]
 ```

1-js/05-data-types/05-array-methods/4-sort-back/task.md

@@ -2,13 +2,12 @@ importance: 4
 
 ---
 
-# Sort in decreasing order
+# الفرز بالترتيب التنازلي
 
 ```js
 let arr = [5, 2, 1, -10, 8];
 
 // ... your code to sort it in decreasing order
 
-alert( arr ); // 8, 5, 2, 1, -10
+alert(arr); // 8, 5, 2, 1, -10
 ```
-

1-js/05-data-types/05-array-methods/5-copy-sort-array/task.md

@@ -2,17 +2,17 @@ importance: 5
 
 ---
 
-# Copy and sort array
+# نسخ المصفوفة وفرزها
 
-We have an array of strings `arr`. We'd like to have a sorted copy of it, but keep `arr` unmodified.
+في يدنا مصفوفة من السلاسل النصية arr. نريد نسخة مرتّبة عنها وترك arr بلا تعديل.
 
-Create a function `copySorted(arr)` that returns such a copy.
+أنشِئ دالة copySorted(arr)‎ تُعيد هذه النسخة.
 
 ```js
 let arr = ["HTML", "JavaScript", "CSS"];
 
 let sorted = copySorted(arr);
 
-alert( sorted ); // CSS, HTML, JavaScript
-alert( arr ); // HTML, JavaScript, CSS (no changes)
+alert(sorted); // CSS, HTML, JavaScript
+alert(arr); // HTML, JavaScript, CSS (no changes)
 ```

1-js/05-data-types/05-array-methods/6-array-get-names/task.md

@@ -2,21 +2,18 @@ importance: 5
 
 ---
 
-# Map to names
+# خارطة بالأسماء
 
-You have an array of `user` objects, each one has `user.name`. Write the code that converts it into an array of names.
+لدينا مصفوفة من كائنات user، لكلّ منها صفة user.name. اكتب كودًا يحوّلها إلى مصفوفة من الأسماء.
 
-For instance:
+مثال:
 
 ```js no-beautify
 let john = { name: "John", age: 25 };
 let pete = { name: "Pete", age: 30 };
 let mary = { name: "Mary", age: 28 };
 
-let users = [ john, pete, mary ];
+let users = [john, pete, mary];
 
-let names = /* ... your code */
-
-alert( names ); // John, Pete, Mary
+let names /* ... your code */ = alert(names); // John, Pete, Mary
 ```
-