Added 'readSDfile' method.

Author: michalmonday

CSV_Parser.cpp

@@ -1,6 +1,7 @@
 /*  https://github.com/michalmonday/CSV-Parser-for-Arduino  */
 
 #include "CSV_Parser.h"
+#include <SD.h>
 
 //#include "mem_check.h" // COMMENT-OUT BEFORE UPLOAD
 
@@ -104,6 +105,24 @@ CSV_Parser::~CSV_Parser() {
   free(leftover);
 }
 
+bool CSV_Parser::readSDfile(const char *f_name) {
+  // open the file. note that only one file can be open at a time,
+  // so you have to close this one before opening another.
+  File csv_file = SD.open(f_name);
+  if (!csv_file) 
+    return false;
+    
+  // read file and supply it to csv parser
+  while (csv_file.available())
+    *this << csv_file.read();
+  
+  csv_file.close();
+  
+  // ensure that the last value of the file is parsed (even if the file doesn't end with '\n')
+  parseLeftover();
+  return true;
+}
+
 /*  It ensures that '\r\n' characters, delimiter and quote characters that are enclosed within string 
     value itself are properly parsed. It dynamically allocates memory, creates copy of parsed string 
     value and returns a pointer to it. Memory is supposed to be released outside of this function.  
@@ -440,4 +459,4 @@ void CSV_Parser::parseLeftover() {
     free(leftover);
     leftover = 0;
   }
-}
+}

CSV_Parser.h

@@ -111,6 +111,12 @@ class CSV_Parser {
   /** @brief Releases all dynamically allocated memory.  
 	  Making values unusable once the CSV_Parser goes out of scope.  */
   ~CSV_Parser();
+
+  /** @brief Reads file from SD card. 
+      @param f_name - file name (provided file must have format that was supplied in CSV_Parser constructor)
+      @return True if file could be read, false if not.
+    It requires previously calling "SD.begin()".  */
+  bool readSDfile(const char *f_name);
 
   int getColumnsCount();
 

examples/reading_from_sd_card/reading_from_sd_card.ino

@@ -34,35 +34,10 @@ void setup() {
   }
   Serial.println("card initialized.");
 
-  // open the file. note that only one file can be open at a time,
-  // so you have to close this one before opening another.
-  File csv_file = SD.open("file.csv");
 
   CSV_Parser cp(/*format*/ "dd", /*has_header*/ true, /*delimiter*/ ',');
- 
-  if (!csv_file) {
-    Serial.println("error opening file.csv");
-    
-    // don't do anything more:
-    while (1);
-  }
-
-  // read file and supply it to csv parser
-  while (csv_file.available()) {
-    cp << csv_file.read();
-  }
-  csv_file.close();
-
-  // ensure that the last value of the file is parsed (even if the file doesn't end with '\n')
-  cp.parseLeftover();
-
-  // output parsed values (allows to check that the file was parsed correctly)
-  cp.print(); // assumes that "Serial.begin()" was called before (otherwise it won't work)
-
-
+  cp.readSDfile("file.csv"); // this wouldn't work if SD.begin wasn't called before
 
-  
-  // Getting all the values:
   int16_t *column_1 = (int16_t*)cp["column_1"];
   int16_t *column_2 = (int16_t*)cp["column_2"];
 
@@ -78,6 +53,9 @@ void setup() {
   } else {
     Serial.println("At least 1 of the columns was not found, something went wrong.");
   }
+
+  // output parsed values (allows to check that the file was parsed correctly)
+  cp.print(); // assumes that "Serial.begin()" was called before (otherwise it won't work)
 }
 
 void loop() {

keywords.txt

@@ -18,6 +18,7 @@ print	KEYWORD2
 printKeys	KEYWORD2
 setDebugSerial	KEYWORD2
 parseLeftover	KEYWORD2
+readSDfile	KEYWORD2
 
 ######################################
 # Constants (LITERAL1)

library.properties

@@ -1,5 +1,5 @@
 name=CSV Parser
-version=0.1.4
+version=0.2.0
 author=Michal Borowski <michalmonday17@gmail.com>
 maintainer=Michal Borowski <michalmonday17@gmail.com>
 sentence=CSV Parser for Arduino.