first commit

.gitignore

@@ -0,0 +1,115 @@
+# Created by .ignore support plugin (hsz.mobi)
+### Java template
+# Compiled class file
+*.class
+
+# Log file
+*.log
+
+# BlueJ files
+*.ctxt
+
+# Mobile Tools for Java (J2ME)
+.mtj.tmp/
+
+# Package Files #
+*.jar
+*.war
+*.ear
+*.zip
+*.tar.gz
+*.rar
+
+# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
+hs_err_pid*
+### Eclipse template
+
+.metadata
+bin/
+tmp/
+*.tmp
+*.bak
+*.swp
+*~.nib
+local.properties
+.settings/
+.loadpath
+.recommenders
+
+# Eclipse Core
+.project
+
+# External tool builders
+.externalToolBuilders/
+
+# Locally stored "Eclipse launch configurations"
+*.launch
+
+# PyDev specific (Python IDE for Eclipse)
+*.pydevproject
+
+# CDT-specific (C/C++ Development Tooling)
+.cproject
+
+# JDT-specific (Eclipse Java Development Tools)
+.classpath
+
+# Java annotation processor (APT)
+.factorypath
+
+# PDT-specific (PHP Development Tools)
+.buildpath
+
+# sbteclipse plugin
+.target
+
+# Tern plugin
+.tern-project
+
+# TeXlipse plugin
+.texlipse
+
+# STS (Spring Tool Suite)
+.springBeans
+
+# Code Recommenders
+.recommenders/
+
+# Scala IDE specific (Scala & Java development for Eclipse)
+.cache-main
+.scala_dependencies
+.worksheet
+### macOS template
+*.DS_Store
+.AppleDouble
+.LSOverride
+
+# Icon must end with two \r
+Icon
+
+
+# Thumbnails
+._*
+
+# Files that might appear in the root of a volume
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+
+#Intellij files
+.idea
+*.iml
+
+#maven build target
+target/

README.md

@@ -0,0 +1,245 @@
+## Building Utility Class for String Array Objects
+* **Objective**
+    * To complete the utility methods in the class [StringArrayUtils]()
+        * `int getNumberOfOccurrences(String[] stringArray, String stringToCheck)`
+        * `boolean contains(String[] stringArray, String stringToCheck)`
+        * `String[] removeValue(String[] stringArray, String stringToRemove)`
+        
+* **Purpose**
+    * To establish greater familiarity with loops and arrays.
+    * To demonstrate the implementation of a [Utility class](https://www.quora.com/What-is-a-utility-class)
+    
+    
+
+
+
+
+
+
+
+<br><br><br><br>
+## Sample Behavior - `StringArrayUtils.removeValues(array, valueToRemove)`
+* **Description**
+    * Given an array of `String` objects named `array` and a `String` object named `valueToRemove`<br>create and return an array containing identical contents excluding objects whose value is equivalent to `valueToRemove`. Ensure that the length of the newly created array has been resized based on the removal of the undesired elements. 
+        
+### Example 1
+* Sample Script
+
+    ```
+    // : Given
+    String[] array = {"aba", "aba", "baa", "bab", "bba", "bba", "bba", "bba", "bbb", "bbb"};
+    
+    // : When
+    String[] actual = StringArrayUtils.removeValues(array, "aba");
+    
+    // : Then
+    System.out.println(Arrays.toString(actual));
+    ```
+
+
+
+* Sample Output
+    ```
+    [baa, bab, bba, bba, bba, bba, bbb, bbb};
+    ```
+    
+    
+
+### Example 2
+* Sample Script
+
+    ```
+    // : Given
+    String[] array = {"aba", "aba", "baa", "bab", "bba", "bba", "bba", "bba", "bbb", "bbb"};
+    
+    // : When
+    String[] actual = StringArrayUtils.removeValues(array, "bba");
+    
+    // : Then
+    System.out.println(Arrays.toString(actual));
+    ```
+
+
+
+* Sample Output
+    ```
+    [aba, aba, baa, bab, bbb, bbb];
+    ```
+    
+    
+
+### Example 3
+* Sample Script
+
+    ```
+    // : Given
+    String[] array = {"aba", "aba", "baa", "bab", "bba", "bba", "bba", "bba", "bbb", "bbb"};
+    
+    // : When
+    String[] actual = StringArrayUtils.removeValues(array, "bbb");
+    
+    // : Then
+    System.out.println(Arrays.toString(actual));
+    ```
+
+
+
+* Sample Output
+    ```
+    [aba, aba, baa, bab, bba, bba, bba, bba];
+    ```
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<br><br><br><br>
+## Sample Behavior - `StringArrayUtils.getNumberOfOccurrences(array, value)`
+* **Method Description**
+    * Given an array of `String` objects named `array` and a `String` object named `value`<br>return the number of times `value` appears in `arrays`
+
+### Example 1
+* Sample Script
+
+    ```
+    // : Given
+    String[] array = {"aba", "aba", "baa", "bab", "bba", "bba", "bba", "bba", "bbb", "bbb"};
+    
+    // : When
+    int numberOfOccurrences = StringArrayUtils.getNumberOfOccurrences(array, "bba");
+    
+    // : Then
+    System.out.println(numberOfOccurrences);
+    ```
+
+
+
+* Sample Output
+
+    ```
+    4
+    ```
+    
+    
+    
+
+### Example 2
+* Sample Script
+
+    ```
+    // : Given
+    String[] array = {"aba", "aba", "baa", "bab", "bba", "bba", "bba", "bba", "bbb", "bbb"};
+    
+    // : When
+    int numberOfOccurrences = StringArrayUtils.getNumberOfOccurrences(array, "bbb");
+    
+    // : Then
+    System.out.println(numberOfOccurrences);
+    ```
+
+
+
+* Sample Output
+
+    ```
+    2
+    ```
+    
+
+### Example 3
+* Sample Script
+
+    ```
+    // : Given
+    String[] array = {"aba", "aba", "baa", "bab", "bba", "bba", "bba", "bba", "bbb", "bbb"};
+    
+    // : When
+    int numberOfOccurrences = StringArrayUtils.getNumberOfOccurrences(array, "baa");
+    
+    // : Then
+    System.out.println(numberOfOccurrences);
+    ```
+
+
+
+* Sample Output
+
+    ```
+    1
+    ```
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<br><br><br><br>
+## Sample Behavior - `StringArrayUtils.contains(array, value)`
+
+### Example 1
+* Sample Script
+
+    ```
+    // : Given
+    String[] array = {"the", "quick", "brown", "fox", "jumps", "over", "the", "lazy", "dog"};
+    
+    // : When
+    boolean outcome = StringArrayUtils.contains(array, "the");
+    
+    // : Then
+    System.out.println(outcome);
+    ```
+
+
+
+* Sample Output
+
+    ```
+    true
+    ```
+    
+    
+    
+
+### Example 2
+* Sample Script
+
+    ```
+    // : Given
+    String[] array = {"the", "quick", "brown", "fox", "jumps", "over", "the", "lazy", "dog"};
+    
+    // : When
+    boolean outcome = StringArrayUtils.contains(array, "potatoes");
+    
+    // : Then
+    System.out.println(outcome);
+    ```
+
+
+
+* Sample Output
+
+    ```
+    false
+    ```

pom.xml

@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>com.zipcodewilmington.labs</groupId>
+    <artifactId>arrayutils</artifactId>
+    <version>1.0-SNAPSHOT</version>
+    <dependencies>
+        <dependency>
+            <groupId>junit</groupId>
+            <artifactId>junit</artifactId>
+            <version>4.12</version>
+        </dependency>
+    </dependencies>
+
+
+</project>

src/main/java/com/zipcodewilmington/StringArrayUtils.java

@@ -0,0 +1,35 @@
+package com.zipcodewilmington;
+
+/**
+ * Created by leon on 1/29/18.
+ */
+public class StringArrayUtils {
+    /**
+     * @param array - array of String objects
+     * @param value - value to check array for
+     * @return - number of occurrences the specified `value` has occurred
+     */ // TODO
+    public static int getNumberOfOccurrences(String[] array, String value) {
+        return 0;
+    }
+
+    /**
+     * @param array - array of String objects
+     * @param value - value to check array for
+     * @return - true if the array contains the specified `value`
+     */
+    public static boolean contains(String[] array, String value) {
+        return false;
+    }
+
+
+    /**
+     * @param array - array of String objects
+     * @param valueToRemove - value to remove from array
+     * @return - array with identical contents excluding values of `value`
+     */
+
+    public static String[] removeValue(String[] array, String valueToRemove) {
+        return null;
+    }
+}

src/test/java/com/zipcodewilmington/StringArrayUtilsTest.java

@@ -0,0 +1,54 @@
+package com.zipcodewilmington;
+
+import org.junit.Assert;
+import org.junit.Test;
+
+/**
+ * Created by leon on 1/29/18.
+ */
+public class StringArrayUtilsTest {
+    private static final String[] testArray = {"the", "quick", "brown", "fox", "jumps", "over", "the", "lazy", "dog"};
+
+    @Test
+    public void testContains() {
+        for (String s : testArray) {
+            boolean outcome = StringArrayUtils.contains(testArray, s);
+            Assert.assertTrue(outcome);
+        }
+    }
+
+    @Test
+    public void testRemoveValue() {
+        String[] expected = {"quick", "brown", "fox", "jumps", "over", "the", "lazy", "dog"};
+        String[] actual = StringArrayUtils.removeValue(expected, "The");
+        Assert.assertEquals(expected, actual);
+    }
+
+    @Test
+    public void testRemoveValue1() {
+        String[] expected = {"the", "brown", "fox", "jumps", "over", "the", "lazy", "dog"};
+        String[] actual = StringArrayUtils.removeValue(expected, "quick");
+        Assert.assertEquals(expected, actual);
+    }
+
+    @Test
+    public void testRemoveValue2() {
+        String[] expected = {"the", "quick", "fox", "jumps", "over", "the", "lazy", "dog"};
+        String[] actual = StringArrayUtils.removeValue(expected, "brown");
+        Assert.assertEquals(expected, actual);
+    }
+
+    @Test
+    public void testGetNumberOfOccurrences1() {
+        int expected = 2;
+        int actual = StringArrayUtils.getNumberOfOccurrences(testArray, "the");
+        Assert.assertEquals(expected, actual);
+    }
+
+    @Test
+    public void testGetNumberOfOccurrences2() {
+        int expected = 1;
+        int actual = StringArrayUtils.getNumberOfOccurrences(testArray, "quick");
+        Assert.assertEquals(expected, actual);
+    }
+}