Merge branch 'release/v1.3.0'

Author: ianriizky

CHANGELOG.md

@@ -4,6 +4,16 @@ Semua pembaruan pada `coding-interview` akan didokumentasikan pada dokumen ini.
 
 ## [Unreleased](https://github.com/ianriizky/coding-interview/compare/master...develop)
 
+## [v1.3.0 (2021-12-30)](https://github.com/ianriizky/coding-interview/compare/v1.2.0...v1.3.0)
+
+### Baru
+- Studi kasus faktorial ([#1194c5c](https://github.com/ianriizky/coding-interview/commit/1194c5c041dd929af02aec2a0bd809229d893bc8)).
+
+### Perubahan
+- Menambah keterangan UNLISTED di video youtube Programmer Zaman Now dataset ([#9dfd4d0](https://github.com/ianriizky/coding-interview/commit/9dfd4d03bb7b2f8540ac6931c38877ec8ab79bae)).
+- Perbarui readme di palindrome ([#9dfd4d0](https://github.com/ianriizky/coding-interview/commit/9dfd4d03bb7b2f8540ac6931c38877ec8ab79bae)).
+
+
 ## [v1.2.0 (2021-12-30)](https://github.com/ianriizky/coding-interview/compare/v1.1.4...v1.2.0)
 
 ### Baru

src/DataSet/README.md

@@ -9,5 +9,5 @@ Contoh *source code* dari studi kasus Dataset menggunakan bahasa pemrograman PHP
 
 <strong id="fn1">1</strong> [Pengertian Dataset dan Jenis-jenisnya, Kumparan](https://kumparan.com/kabar-harian/pengertian-dataset-dan-jenis-jenisnya-1wtM6xNlkpQ/2). [↩](#pg1)
 <br>
-<strong id="fn2">2</strong> [Programmer Zaman Now - Coding Interview Struktur Data Set](https://www.youtube.com/watch?v=OWm1vSHrC_A). [↩](#pg2)
+<strong id="fn2">2</strong> [Programmer Zaman Now - Coding Interview Struktur Data Set (UNLISTED)](https://www.youtube.com/watch?v=OWm1vSHrC_A). [↩](#pg2)
 <br>

src/Factorial/1.png

@@ -0,0 +1,77 @@
+<?php
+
+namespace Ianriizky\CodingInterview\Factorial;
+
+class Factorial
+{
+    /**
+     * Temporary value for the recursive value.
+     *
+     * @var int
+     */
+    protected int $result = 1;
+
+    /**
+     * Create a new instance class.
+     *
+     * @param  int  $initialN
+     * @return void
+     */
+    public function __construct(protected int $initialN)
+    {
+        //
+    }
+
+    /**
+     * Return result of the factorial using loop way.
+     *
+     * @return int
+     */
+    public function resultWithLoop(): int
+    {
+        if ($this->initialN <= 1) {
+            return 1;
+        }
+
+        $result = 1;
+
+        for ($n = $this->initialN; $n >= 1; $n--) {
+            $result *= $n;
+        }
+
+        return $result;
+    }
+
+    /**
+     * Return result of the factorial using recursive way.
+     *
+     * @return int
+     */
+    public function resultWithRecursive(): int
+    {
+        if ($this->initialN <= 1) {
+            return 1;
+        }
+
+        $n = $this->initialN;
+
+        return $n * $this->resultWithRecursive($this->initialN = $n - 1);
+    }
+
+    /**
+     * Return result of the factorial using tail recursive way.
+     *
+     * @return int
+     */
+    public function resultWithTailRecursive(): int
+    {
+        if ($this->initialN <= 0) {
+            return $this->result;
+        }
+
+        $this->result *= $this->initialN;
+        $this->initialN--;
+
+        return $this->resultWithTailRecursive();
+    }
+}

src/Factorial/2.png

@@ -0,0 +1,95 @@
+# Faktorial
+
+Dalam matematika, Faktorial dari bilangan bulat positif dari n yang dilambangkan dengan n!, adalah produk dari semua bilangan bulat positif yang kurang dari atau sama dengan n:<sup id="pg1">[1](#fn1)</sup>.
+<br>
+![Rumus Faktorial](1.png)
+Sebagai contoh,
+<br>
+![Contoh Faktorial](2.png)
+<br>
+Nilai 0! adalah 1, menurut konvensi untuk produk kosong.
+
+Pada studi kasus faktorial yang ada di *source code* [ini](Factorial.php), ada 3 metode yang bisa digunakan untuk menghitung nilai faktorial dari n yang diberikan. Metode tersebut di antaranya adalah:
+
+## Metode *loop*<sup id="pg2">[2](#fn2)</sup>
+Di metode ini, kita menggunakan cara yang paling standar yaitu menggunakan perulangan. Contohnya dapat dilihat pada *source code* di bawah ini.
+```php
+if ($value <= 1) {
+    return 1;
+}
+
+$result = 1;
+
+for ($n = $value; $n >= 1; $n--) {
+    $result *= $n;
+}
+
+return $result;
+```
+
+## Metode *recursive*<sup id="pg2">[2](#fn2)</sup>
+Jika pada saat interview kita dilarang untuk menggunakan perulangan, kita bisa menggunakan cara rekursif. Rekursif adalah fungsi yang memanggil fungsi itu sendiri secara berulang. Contohnya dapat dilihat pada *source code* di bawah ini.
+```php
+$this->initialN = 5;
+
+public function resultWithRecursive(): int
+{
+    if ($this->initialN <= 1) {
+        return 1;
+    }
+
+    $n = $this->initialN;
+
+    return $n * $this->resultWithRecursive($this->initialN = $n - 1);
+}
+```
+
+## Metode *tail recursive*<sup id="pg2">[2](#fn2)</sup>
+Jika kita perhatikan pada metode rekursif sebelumnya, kita bisa lihat bahwa fungsi tersebut harus menunggu hingga ke fungsi rekursif yang paling akhir di setiap ia memanggil dirinya sendiri.
+```php
+$this->initialN = 5;
+
+$this->resultWithRecursive();
+// 5 * ($this->resultWithRecursive() = 4)
+// 5 * 4 * ($this->resultWithRecursive() = 3)
+// 5 * 4 * 3 * ($this->resultWithRecursive() = 2)
+// 5 * 4 * 3 * 2 * ($this->resultWithRecursive() = 1)
+// 5 * 4 * 3 * 2 * 1 * ($this->resultWithRecursive() = 0)
+```
+Salah satu masalah yang bisa muncul ketika kita menggunakan metode rekursif adalah terjadinya *memory leak*. Solusi yang bisa digunakan adalah menggunakan *tail recursive*. *Tail recursive* adalah rekursif yang seakan-akan tidak menunggu rekursif sebelumnya. Sehingga hasil eksekusinya akan menjadi seperti berikut ini.
+```php
+$this->initialN = 5;
+
+$this->resultWithTailRecursive();
+// $this->resultWithTailRecursive() // $this->iniitalN = 5, $this->result = 1
+// $this->resultWithTailRecursive() // $this->iniitalN = 4, $this->result = 5
+// $this->resultWithTailRecursive() // $this->iniitalN = 3, $this->result = 20
+// $this->resultWithTailRecursive() // $this->iniitalN = 2, $this->result = 60
+// $this->resultWithTailRecursive() // $this->iniitalN = 1, $this->result = 120
+// $this->resultWithTailRecursive() // $this->iniitalN = 0, $this->result = 120
+```
+
+Contoh dari metode *tail recursive* dapat dilihat pada *source code* di bawah ini.
+```php
+$this->initialN = 5;
+
+public function resultWithTailRecursive(): int
+{
+    if ($this->initialN <= 0) {
+        return $this->result;
+    }
+
+    $this->result *= $this->initialN;
+    $this->initialN--;
+
+    return $this->resultWithTailRecursive();
+}
+```
+
+---
+### Catatan Kaki:
+
+<strong id="fn1">1</strong> [Faktorial, Wikipedia](https://id.wikipedia.org/wiki/Faktorial). [↩](#pg1)
+<br>
+<strong id="fn2">2</strong> [Programmer Zaman Now - Coding Interview Factorial (UNLISTED)](https://www.youtube.com/watch?v=tcPmCOAl-X4). [↩](#pg2)
+<br>

src/Factorial/Factorial.php

@@ -54,22 +54,27 @@ Ada optimasi yang dilakukan pada *source code* di atas, di mana batas perulangan
 ## Metode *recursive*<sup id="pg5">[5](#fn5)</sup>
 Metode ini prinsipnya hampir sama dengan metode *loop* yang telah dijelaskan sebelumnya. Perbedaan dari metode *recursive* ini hanya terletak pada dihilangkannya perulangan ``for()`` dan pengecekan batas perulangan diganti menjadi ``if ($index < floor(strlen($value) / 2))`` sehingga menghasilkan pemanggilan fungsi yang sama secara *recursive* sebagaimana dapat dilihat pada *source code* di bawah ini.
 ```php
-$value = 'katak';
+$this->value = 'katak';
 
-if ($index < floor(strlen($value) / 2)) {
-    $lastCharacterIndex = strlen($value) - ($index + 1);
+public function checkUsingRecursive(int $index = 0): bool
+{
+    $value = $this->value;
 
-    $firstCharacter = $value[$index];
-    $lastCharacter = $value[$lastCharacterIndex];
+    if ($index < floor(strlen($value) / 2)) {
+        $lastCharacterIndex = strlen($value) - ($index + 1);
 
-    if ($firstCharacter !== $lastCharacter) {
-        return false;
+        $firstCharacter = $value[$index];
+        $lastCharacter = $value[$lastCharacterIndex];
+
+        if ($firstCharacter !== $lastCharacter) {
+            return false;
+        }
+
+        return $this->checkUsingRecursive($index + 1);
     }
 
-    return $this->checkUsingRecursive($index + 1); // kunci recursive ada di sini
+    return true;
 }
-
-return true;
 ```
 
 ---

src/Factorial/README.md

@@ -0,0 +1,69 @@
+<?php
+
+namespace Tests\Unit;
+
+use Ianriizky\CodingInterview\Factorial\Factorial;
+use Tests\TestCase;
+
+class FactorialTest extends TestCase
+{
+    protected array $factorials = [
+        0 => 1,
+        1 => 1,
+        2 => 2,
+        3 => 6,
+        4 => 24,
+        5 => 120,
+        6 => 720,
+        7 => 5040,
+        8 => 40320,
+        9 => 362880,
+        10 => 3628800,
+        11 => 39916800,
+        12 => 479001600,
+        13 => 6227020800,
+        14 => 87178291200,
+        15 => 1307674368000,
+        16 => 20922789888000,
+        17 => 355687428096000,
+        18 => 6402373705728000,
+        19 => 121645100408832000,
+        20 => 2432902008176640000,
+    ];
+
+    /**
+     * Assert that factorial class with loop is run correctly.
+     *
+     * @return void
+     */
+    public function test_factorial_with_loop()
+    {
+        foreach ($this->factorials as $n => $factorial) {
+            $this->assertEquals($factorial, (new Factorial($n))->resultWithLoop());
+        }
+    }
+
+    /**
+     * Assert that factorial class with recursive is run correctly.
+     *
+     * @return void
+     */
+    public function test_factorial_with_recursive()
+    {
+        foreach ($this->factorials as $n => $factorial) {
+            $this->assertEquals($factorial, (new Factorial($n))->resultWithRecursive());
+        }
+    }
+
+    /**
+     * Assert that factorial class with tail recursive is run correctly.
+     *
+     * @return void
+     */
+    public function test_factorial_with_tail_recursive()
+    {
+        foreach ($this->factorials as $n => $factorial) {
+            $this->assertEquals($factorial, (new Factorial($n))->resultWithTailRecursive());
+        }
+    }
+}