ws-3270: add gender as string

Author: Adam Soos

examples/name_similarity.php

@@ -17,7 +17,7 @@
 $name_similarity_data1 = "Michael Jackson";
 $name_similarity_data2 = "迈克尔·杰克逊";
 $api = isset($options['url']) ? new Api($options['key'], $options['url']) : new Api($options['key']);
-$params = new NameSimilarityParameters(new Name($name_similarity_data1), new Name($name_similarity_data2));
+$params = new NameSimilarityParameters(new Name($name_similarity_data1, gender: 'male'), new Name($name_similarity_data2, gender: 'female'));
 
 try {
     $result = $api->nameSimilarity($params);

source/rosette/api/Name.php

@@ -47,17 +47,25 @@ class Name extends RosetteParamsSetBase
      */
     public $script;
 
+    /**
+     * Gender of the name. Can be MALE, FEMALE and NONBINARY
+     *
+     * @var string
+     */
+     public $gender;
+
     /**
      * Constructor.
      *
      * @param $text
      * @param $entityType
      * @param $language
      * @param $script
+     * @param $gender
      *
      * @throws RosetteException
      */
-    public function __construct($text, $entityType = null, $language = null, $script = null)
+    public function __construct($text, $entityType = null, $language = null, $script = null, $gender = null)
     {
         if ($text === null) {
             throw new RosetteException(
@@ -69,6 +77,7 @@ public function __construct($text, $entityType = null, $language = null, $script
         $this->entityType = $entityType;
         $this->language = $language;
         $this->script = $script;
+        $this->gender = $gender;
     }
 
     /**