Add CVSRecord.isMapped(String) API.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/csv/trunk@1397094 13f79535-47bb-0310-9956-ffa450edef68

Author: garydgregory

src/main/java/org/apache/commons/csv/CSVRecord.java

@@ -60,21 +60,32 @@ public String get(int i) {
      * Returns a value by name.
      *
      * @param name
-     *            the name of the column to be retrieved
+     *            the name of the column to be retrieved.
      * @return the column value, or {@code null} if the column name is not found
      * @throws IllegalStateException
      *             if no header mapping was provided
      */
     public String get(String name) {
         if (mapping == null) {
-            throw new IllegalStateException("No header was specified, the record values can't be accessed by name");
+            throw new IllegalStateException("No header mapping was specified, the record values can't be accessed by name");
         }
 
         Integer index = mapping.get(name);
 
         return index != null ? values[index.intValue()] : null;
     }
 
+    /**
+     * Checks whether a given columns is mapped.
+     * 
+     * @param name
+     *            the name of the column to be retrieved.
+     * @return whether a given columns is mapped.
+     */
+    public boolean isMapped(String name) {
+        return mapping != null ? mapping.containsKey(name) : false;
+    }
+    
     public Iterator<String> iterator() {
         return Arrays.asList(values).iterator();
     }

src/test/java/org/apache/commons/csv/CSVParserTest.java

@@ -503,6 +503,10 @@ public void testProvidedHeader() throws Exception {
         for (int i = 0; i < 3; i++) {
             assertTrue(records.hasNext());
             CSVRecord record = records.next();
+            assertTrue(record.isMapped("A"));
+            assertTrue(record.isMapped("B"));
+            assertTrue(record.isMapped("C"));
+            assertFalse(record.isMapped("NOT MAPPED"));
             assertEquals(record.get(0), record.get("A"));
             assertEquals(record.get(1), record.get("B"));
             assertEquals(record.get(2), record.get("C"));