Using the library

Include mastodonpp.hpp, which then includes all other headers.

#include <mastodonpp/mastodonpp.hpp>

Use it in your CMake project like this:

find_package(mastodonpp REQUIRED CONFIG)

target_link_libraries(MyProject mastodonpp::mastodonpp)

Or compile your code with g++ $(pkg-config --cflags --libs mastodonpp).

Example

#include <mastodonpp/mastodonpp.hpp>
#include <iostream>
 
int main()
{
    mastodonpp::Instance instance{"example.com", ""};
    std::cout << "Maximum characters per post: "
              << instance.get_max_chars() << std::endl;
 
    mastodonpp::Connection connection{instance};
 
    auto answer{connection.get(mastodonpp::API::v1::instance)};
    if (answer)
    {
        std::cout << answer << std::endl;
    }
}

Input

All text input is expected to be UTF-8.

Exceptions

Any unrecoverable libcurl error will be thrown as a mastodonpp::CURLException. Network errors will not be thrown, but reported via the return value.

Thread safety

The first time you construct an Instance or Connection , curl_global_init(3) is called. When the last Instance or Connection is destroyed, curl_global_cleanup(3) is called. Both are not thread safe.