From e9f8a5eb254edc78a22e56eb1c48fa8c6569e69e Mon Sep 17 00:00:00 2001
From: Nuno Jesus <ncarvalh@student.42porto.com>
Date: Mon, 31 Jul 2023 20:14:10 +0100
Subject: [PATCH] README: added findstring function section.

---
 README.md                           | 42 +++++++++++++++++++++++++++--
 code/18-findstring-example/Makefile |  6 +++++
 2 files changed, 46 insertions(+), 2 deletions(-)
 create mode 100644 code/18-findstring-example/Makefile

diff --git a/README.md b/README.md
index ffe6f75..0a8381b 100644
--- a/README.md
+++ b/README.md
@@ -33,6 +33,8 @@ It starts with a beginner's guide, followed up by some medium-advanced concepts.
 		<ul style="list-style-type:disc">
 			<li><a href="#functions-1">A4.1 - Functions Call Syntax</a></li>
 			<li><a href="#functions-2">A4.2 - Functions for String Manipulation</a></li>
+			<li><a href="#functions-3">A4.3 - Functions for File Names</a></li>
+			<li><a href="#functions-4">A4.4 - Functions for Generic Purpose</</li>a>
 		</ul>
 		<!-- <li><a href="#vpath">The vpath directive</a></li> -->
 	</ul>
@@ -1088,7 +1090,7 @@ BAR=a,b,c
 
 ### <a name="functions-2">A4.2 - Functions for String Manipulation</a>
 
-<details open>
+<details>
 	<summary><h4>patsubst</h4> - replaces string patterns</summary>
 	
 ```
@@ -1165,11 +1167,38 @@ RESULT == a b c
 ```
 </details>
 
+<details>
+	<summary><h4>findstring</h4> - looks for occurrences of a string</summary>
+
+```
+$(findstring find,in)
+```
+
+If the text `in` contains a word identical to `find`, the function returns `find`. Otherwise, it returns the empty string.
+
+Here's an example ([code/18-findstring-example](code/18-findstring-example)):
+
+```Makefile
+NAME = Nuno Jesus
+
+all:
+	echo Result=$(findstring Jesus, $(NAME))
+	echo Result=$(findstring Miguel, $(NAME))
+.SILENT:
+```
+
+Output:
+
+```
+Result=Jesus
+Result=
+```
+
+</details>
 
 <!-- 
 	Functions for strings manipulation
 	
-	$(findstring find,in)
 	$(filter pattern…,text)
 	$(words text)
 
@@ -1547,6 +1576,15 @@ Self-explanatory, you forgot to add an `endif` directive to your conditional.
 
 ------------------------------------------------------------------
 
+### <a name="functions-3">A4.3 - Functions for File Names</a>
+
+
+------------------------------------------------------------------
+
+### <a name="functions-4">A4.4 - Functions for Generic Purpose</a>
+
+
+------------------------------------------------------------------
 
 ## 📞 **Contact me**
 Feel free to ask me any questions through Slack (**ncarvalh**).
diff --git a/code/18-findstring-example/Makefile b/code/18-findstring-example/Makefile
new file mode 100644
index 0000000..f1ab4ed
--- /dev/null
+++ b/code/18-findstring-example/Makefile
@@ -0,0 +1,6 @@
+NAME = Nuno Jesus
+
+all:
+	echo Result=$(findstring Jesus, $(NAME))
+	echo Result=$(findstring Miguel, $(NAME))
+.SILENT:
\ No newline at end of file