feat: adding locale to word module

CHANGELOG.md

@@ -16,6 +16,7 @@ All notable changes to this project will be documented in this file
 * added locale to `weather` module
 * added locale to `color` module
 * added locale to `vehicle` module
+* added locale to `word` module
 
 ## v3.0.0 (28.08.2024)
 

include/faker-cxx/word.h

@@ -8,13 +8,17 @@
 #include "faker-cxx/export.h"
 #include "faker-cxx/helper.h"
 
+#include "faker-cxx/types/locale.h"
+
 namespace faker::word
 {
+
 /**
  * @brief Returns a random .
  *
  * @param length The expected length of the .
- * If no  with given length will be found, it will return a random .
+ * If no word with given length will be found or length is 0, it will return a random size word. 
+ * @param locale The locale. Defaults to `Locale::en_US`. 
  *
  * @returns Random sample word.
  *
@@ -23,12 +27,13 @@ namespace faker::word
  * faker::word::sample(5) // "spell"
  * @endcode
  */
-FAKER_CXX_EXPORT std::string_view sample(std::optional<unsigned> length = std::nullopt);
+FAKER_CXX_EXPORT std::string_view sample(std::optional<unsigned> length = std::nullopt,const Locale locale = Locale::en_US);
 
 /**
  * @brief Returns a string containing a number of space separated random words.
  *
  * @param numberOfWords The number of words to generate.
+ * @param locale The locale. Defaults to `Locale::en_US`. 
  *
  * @returns Random words separated with spaces.
  *
@@ -37,13 +42,16 @@ FAKER_CXX_EXPORT std::string_view sample(std::optional<unsigned> length = std::n
  * faker::word::words(5) // "before hourly patiently dribble equal"
  * @endcode
  */
-FAKER_CXX_EXPORT std::string words(unsigned numberOfWords = 1);
+FAKER_CXX_EXPORT std::string words(unsigned numberOfWords = 1,const Locale locale = Locale::en_US);
+
+
 
 /**
  * @brief Returns a random adjective.
  *
  * @param length The expected length of the word.
- * If no word with given length will be found, it will return a random word.
+ * If no adjective with given length will be found or length is 0, it will return a random size adjective. 
+ * @param locale The locale. Defaults to `Locale::en_US`.  
  *
  * @returns Adjective.
  *
@@ -52,13 +60,31 @@ FAKER_CXX_EXPORT std::string words(unsigned numberOfWords = 1);
  * faker::word::adjective(3) // "bad"
  * @endcode
  */
-FAKER_CXX_EXPORT std::string_view adjective(std::optional<unsigned> length = std::nullopt);
+FAKER_CXX_EXPORT std::string_view adjective(std::optional<unsigned> length = std::nullopt,const Locale locale = Locale::en_US);
+
+
+/**
+ * @brief Returns a random adjective, using locale.
+ *
+ * @param length The expected length of the word. 
+ * If no adjective with given length will be found or length is 0, it will return a random size adjective. 
+ * @param locale The locale. Defaults to `Locale::en_US`. 
+ *
+ * @returns Adjective.
+ *
+ * @code
+ * faker::word::adjective() // "complete"
+ * faker::word::adjective(3) // "bad"
+ * @endcode
+ */
+FAKER_CXX_EXPORT std::string_view adjectiveLocale(unsigned length = 0,const Locale locale = Locale::en_US);
 
 /**
  * @brief Returns a random adverb.
  *
  * @param length The expected length of the word.
- * If no word with given length will be found, it will return a random word.
+ * If no adverb with given length will be found or length is 0, it will return a random size adverb. 
+ * @param locale The locale. Defaults to `Locale::en_US`. 
  *
  * @returns Adverb.
  *
@@ -67,13 +93,15 @@ FAKER_CXX_EXPORT std::string_view adjective(std::optional<unsigned> length = std
  * faker::word::adverb(5) // "almost"
  * @endcode
  */
-FAKER_CXX_EXPORT std::string_view adverb(std::optional<unsigned> length = std::nullopt);
+FAKER_CXX_EXPORT std::string_view adverb(std::optional<unsigned> length = std::nullopt,const Locale locale = Locale::en_US);
+
 
 /**
  * @brief Returns a random conjunction.
  *
- * @param length The expected length of the word.
- * If no word with given length will be found, it will return a random word.
+ * @param length The expected length of the word.  
+ * If no conjunction with given length will be found or length is 0, it will return a random size conjunction. 
+ * @param locale The locale. Defaults to `Locale::en_US`. 
  *
  * @returns Conjunction.
  *
@@ -82,13 +110,16 @@ FAKER_CXX_EXPORT std::string_view adverb(std::optional<unsigned> length = std::n
  * faker::word::conjunction(6) // "indeed"
  * @endcode
  */
-FAKER_CXX_EXPORT std::string_view conjunction(std::optional<unsigned> length = std::nullopt);
+FAKER_CXX_EXPORT std::string_view conjunction(std::optional<unsigned> length = std::nullopt,const Locale locale = Locale::en_US);
+
+
 
 /**
  * @brief Returns a random interjection.
  *
  * @param length The expected length of the word.
- * If no word with given length will be found, it will return a random word.
+ * If no interjection with given length is found or length is 0, it will return a random size interjection. 
+ * @param locale The locale. Defaults to `Locale::en_US`. 
  *
  * @returns Interjection.
  *
@@ -97,13 +128,16 @@ FAKER_CXX_EXPORT std::string_view conjunction(std::optional<unsigned> length = s
  * faker::word::interjection(4) // "yuck"
  * @endcode
  */
-FAKER_CXX_EXPORT std::string_view interjection(std::optional<unsigned> length = std::nullopt);
+FAKER_CXX_EXPORT std::string_view interjection(std::optional<unsigned> length = std::nullopt,const Locale locale = Locale::en_US);
+
+
 
 /**
  * @brief Returns a random noun.
  *
  * @param length The expected length of the word.
- * If no word with given length will be found, it will return a random word.
+ * If no noun with given length is found or length is 0, it will return a random size noun. 
+ * @param locale The locale. Defaults to `Locale::en_US`. 
  *
  * @returns Noun.
  *
@@ -112,13 +146,15 @@ FAKER_CXX_EXPORT std::string_view interjection(std::optional<unsigned> length =
  * faker::word::noun(8) // "distance"
  * @endcode
  */
-FAKER_CXX_EXPORT std::string_view noun(std::optional<unsigned> length = std::nullopt);
+FAKER_CXX_EXPORT std::string_view noun(std::optional<unsigned> length = std::nullopt,const Locale locale = Locale::en_US);
+
 
 /**
  * @brief Returns a random preposition.
  *
  * @param length The expected length of the word.
- * If no word with given length will be found, it will return a random word.
+ * If no preposition with given length is found or length is 0, it will return a random size preposition. 
+ * @param locale The locale. Defaults to `Locale::en_US`. 
  *
  * @returns Preposition.
  *
@@ -127,13 +163,15 @@ FAKER_CXX_EXPORT std::string_view noun(std::optional<unsigned> length = std::nul
  * faker::word::preposition(4) // "from"
  * @endcode
  */
-FAKER_CXX_EXPORT std::string_view preposition(std::optional<unsigned> length = std::nullopt);
+FAKER_CXX_EXPORT std::string_view preposition(std::optional<unsigned> length = std::nullopt,const Locale locale = Locale::en_US);
+
 
 /**
  * @brief Returns a random verb.
  *
  * @param length The expected length of the word.
- * If no word with given length will be found, it will return a random word.
+ * If no verb with given length is found or length is 0, it will return a random size verb. 
+ * @param locale The locale. Defaults to `Locale::en_US`. 
  *
  * @returns Verb.
  *
@@ -142,12 +180,14 @@ FAKER_CXX_EXPORT std::string_view preposition(std::optional<unsigned> length = s
  * faker::word::verb(9) // "stabilise"
  * @endcode
  */
-FAKER_CXX_EXPORT std::string_view verb(std::optional<unsigned> length = std::nullopt);
+FAKER_CXX_EXPORT std::string_view verb(std::optional<unsigned> length = std::nullopt,const Locale locale = Locale::en_US);
+
 
 /**
  * @brief Returns random element of length
  *
  * @param length The length of the elements to be picked from
+ * @param locale The locale. Defaults to `Locale::en_US`. 
  *
  * @ range The range of elements
  *