Add DELETE example.

examples/example07_delete_status.cpp

@@ -0,0 +1,98 @@
+/*  This file is part of mastodonpp.
+ *  Copyright © 2020 tastytea <tastytea@tastytea.de>
+ *
+ *  Permission to use, copy, modify, and/or distribute this software for any
+ *  purpose with or without fee is hereby granted.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+ *  WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+ *  MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
+ *  SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+ *  WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
+ *  OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
+ *  CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+ */
+
+// Post a status (/api/v1/status), then delete it (/api/v1/statuses/:id).
+
+#include "mastodonpp.hpp"
+
+#include <chrono>
+#include <iostream>
+#include <string>
+#include <string_view>
+#include <thread>
+#include <vector>
+
+namespace masto = mastodonpp;
+using namespace std::chrono_literals;
+using std::cout;
+using std::cerr;
+using std::endl;
+using std::to_string;
+using std::string_view;
+using std::this_thread::sleep_for;
+using std::vector;
+
+int main(int argc, char *argv[])
+{
+    const vector<string_view> args(argv, argv + argc);
+    if (args.size() <= 2)
+    {
+        cerr << "Usage: " << args[0] << " <instance hostname> <access token>\n";
+        return 1;
+    }
+
+    try
+    {
+        // Initialize an Instance and a Connection.
+        masto::Instance instance{args[1], args[2]};
+        masto::Connection connection{instance};
+
+        // Post a status.
+        auto answer{connection.post(masto::API::v1::statuses,
+                                    {{"status", "Delete me."}})};
+        if (answer)
+        {
+            cout << "Successfully posted a status.\n";
+
+            // Get the ID of the post.
+            // You normally would use a JSON parser, of course. I don't use one
+            // because I don't want to add a dependency just for an example.
+            const auto pos{answer.body.rfind(R"("id":")") + 6};
+            const auto endpos{answer.body.find(R"(",)", pos)};
+            const auto id{answer.body.substr(pos, endpos - pos)};
+            cout << "Post has ID: " << id << endl;
+            cout << "Waiting 10 seconds…\n";
+            sleep_for(10s);
+
+            answer = connection.del(masto::API::v1::statuses_id, {{"id", id}});
+            if (answer)
+            {
+                cout << "Successfully deleted the status.\n";
+            }
+        }
+        else
+        {
+            if (answer.curl_error_code == 0)
+            {
+                // If it is no libcurl error, it must be an HTTP error.
+                cerr << "HTTP status: " << answer.http_status << endl;
+            }
+            else
+            {
+                // Network errors like “Couldn't resolve host.”.
+                cerr << "libcurl error " << to_string(answer.curl_error_code)
+                     << ": " << answer.error_message << endl;
+            }
+        }
+    }
+    catch (const masto::CURLException &e)
+    {
+        // Only libcurl errors that are not network errors will be thrown.
+        // There went probably something wrong with the initialization.
+        cerr << e.what() << endl;
+    }
+
+    return 0;
+}

include/mastodonpp.hpp

@@ -104,6 +104,7 @@
  *  @example example04_post_with_attachment.cpp
  *  @example example05_update_notification_settings.cpp
  *  @example example06_update_name.cpp
+ *  @example example07_delete_status.cpp
  */
 
 /*!