Add option for deleting SMS

Author: sebromero

examples/DeleteSMS/DeleteSMS.ino

@@ -0,0 +1,48 @@
+#include "ArduinoCellular.h"
+
+ArduinoCellular cellular = ArduinoCellular();
+
+void printMessages(std::vector<SMS> msg){
+     for(int i = 0; i < msg.size(); i++){
+        Serial.println("SMS:");
+        Serial.print("* Index: "); Serial.println(msg[i].index);
+        Serial.print("* From: "); Serial.println(msg[i].sender);
+        Serial.print("* Timestamp: "); Serial.println(msg[i].timestamp.getISO8601());
+        Serial.println("* Message: "); Serial.println(msg[i].message);
+        Serial.println("--------------------\n");
+    }
+}
+
+void setup(){
+    Serial.begin(115200);
+    while (!Serial);
+    cellular.begin();
+    delay(2000); // Give the modem some time to initialize
+}
+
+void loop(){
+    std::vector<SMS> readSMS = cellular.getReadSMS();
+    if(readSMS.size() > 0){
+        Serial.println("Read SMS:");
+        printMessages(readSMS);
+    }
+
+    std::vector<SMS> unreadSMS = cellular.getUnreadSMS();
+    if(unreadSMS.size() > 0){
+        Serial.println("Unread SMS:");
+        printMessages(unreadSMS);
+    }
+
+    // Prompt user which SMS to delete
+    Serial.println("Enter the index of the SMS you want to delete:");
+    
+    while(Serial.available() == 0);
+    auto index = Serial.readStringUntil('\n').toInt();
+    Serial.println("Deleting SMS...");
+
+    if(cellular.deleteSMS(index)){
+        Serial.println("SMS deleted.");
+    } else {
+        Serial.println("Failed to delete SMS.");
+    }
+}

src/ArduinoCellular.cpp

@@ -380,6 +380,12 @@ std::vector<SMS> ArduinoCellular::getUnreadSMS(){
     }
 }
 
+bool ArduinoCellular::deleteSMS(uint16_t index){
+    String command = "+CMGD=" + String(index);
+    String response = sendATCommand(const_cast<char *>(command.c_str()));
+    return response.indexOf("OK") != -1;
+}
+
 void ArduinoCellular::setDebugStream(Stream &stream){
     this->debugStream = &stream;
 }

src/ArduinoCellular.h

@@ -176,6 +176,14 @@ class ArduinoCellular {
          */
         std::vector<SMS> getUnreadSMS();
 
+        /**
+         * @brief Deletes an SMS message at the specified index.
+         *
+         * @param index The index of the SMS message to delete.
+         * @return True if the SMS message was successfully deleted, false otherwise.
+         */
+        bool deleteSMS(uint16_t index);
+
         /**
          * @brief Sends an AT command to the modem and waits for a response, then returns the response.
          * @param command The AT command to send.