From 2b2a2b61cdaaca66d0b6f8e53c550c9acf34be8b Mon Sep 17 00:00:00 2001
From: "Sean W." <cybersholt@gmail.com>
Date: Sun, 29 Oct 2023 17:14:24 -0400
Subject: [PATCH] Hey Fellow Contributors and creators of this repository!

I'd like to mention that I:
* I have read the Code Of Conduct.
* I have followed all the steps of submission properly.

The contributions that I did in this project are as follows:
1. I added a php file in frontend/src/ that contains a function that retrieves the k largest elements from an array.
2. Added .gitignore, so it wouldn't add PHPStorm's files to the repo.
---
 .gitignore                |  7 ++++++
 README.md                 |  1 +
 contributions/Sean_W.md   |  9 ++++++++
 frontend/src/kLargest.php | 45 +++++++++++++++++++++++++++++++++++++++
 4 files changed, 62 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 contributions/Sean_W.md
 create mode 100644 frontend/src/kLargest.php

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..16a94a2
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,7 @@
+# IntelliJ project files
+.idea/*
+.idea/
+.idea
+*.iml
+out
+gen
diff --git a/README.md b/README.md
index d925c69..898caf0 100644
--- a/README.md
+++ b/README.md
@@ -53,5 +53,6 @@ _Welcome hackers it is really **awesome** have you here! Before start contributi
 | **All-About-Food**      | https://github.com/clubgamma/All-About-Food |
 
 ---
+[Contribution from Sean W](./contributions/Sean_W.md)
 
 **[⬆ back to top](#contents)**
diff --git a/contributions/Sean_W.md b/contributions/Sean_W.md
new file mode 100644
index 0000000..1bff771
--- /dev/null
+++ b/contributions/Sean_W.md
@@ -0,0 +1,9 @@
+Hey Fellow Contributors and creators of this repository!
+
+I'd like to mention that I:
+* I have read the Code Of Conduct.
+* I have followed all the steps of submission properly.
+
+The contributions that I did in this project are as follows:
+1. I added a php file in frontend/src/ that contains a function that retrieves the k largest elements from an array.
+2. Added .gitignore, so it wouldn't add PHPStorm's files to the repo.
diff --git a/frontend/src/kLargest.php b/frontend/src/kLargest.php
new file mode 100644
index 0000000..4f82e8c
--- /dev/null
+++ b/frontend/src/kLargest.php
@@ -0,0 +1,45 @@
+<?php
+/*
+	Description: HacktoberFest2k23
+	Author: Sean W.
+	Author URI: https://www.cybersholt.com
+	Version: 0.0.1
+*/
+
+/**
+ * Retrieves the k largest elements from an array.
+ *
+ * This function sorts the entire array in descending order and then
+ * returns the first k elements.
+ *
+ * @param array $arr Array to get elements from.
+ * @param int   $k   Number of elements to return.
+ *
+ * @return array Returns the k largest elements from $arr.
+ */
+function getKLargestElements( $arr, $k ) {
+	// Sort the array in descending order
+	rsort( $arr );
+
+	// Return the first k elements
+	return array_slice( $arr, 0, $k );
+}
+
+// Example usage
+$arr = [ 3, 1, 4, 1, 5, 9, 2, 6, 5, 3, 5 ];
+$k   = 5;
+
+$largestElements = getKLargestElements( $arr, $k );
+print_r( $largestElements );
+
+/*
+ * Example output:
+ * Array
+ * (
+ *    [0] => 9
+ *    [1] => 6
+ *    [2] => 5
+ *    [3] => 5
+ *    [4] => 5
+ * )
+ */
\ No newline at end of file