mastodonpp/docs/example04_post_with_attachm...

178 lines
12 KiB
HTML

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.9.1"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>mastodonpp: example04_post_with_attachment.cpp</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">mastodonpp
&#160;<span id="projectnumber">0.5.7</span>
</div>
<div id="projectbrief">C++ wrapper for the Mastodon and Pleroma APIs.</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.9.1 -->
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
var searchBox = new SearchBox("searchBox", "search",false,'Search','.html');
/* @license-end */
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
$(function() {
initMenu('',true,false,'search.php','Search');
$(document).ready(function() { init_search(); });
});
/* @license-end */</script>
<div id="main-nav"></div>
</div><!-- top -->
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<div class="header">
<div class="headertitle">
<div class="title">example04_post_with_attachment.cpp</div> </div>
</div><!--header-->
<div class="contents">
<div class="fragment"><div class="line"><span class="comment">/* This file is part of mastodonpp.</span></div>
<div class="line"><span class="comment"> * Copyright © 2020 tastytea &lt;tastytea@tastytea.de&gt;</span></div>
<div class="line"><span class="comment"> *</span></div>
<div class="line"><span class="comment"> * Permission to use, copy, modify, and/or distribute this software for any</span></div>
<div class="line"><span class="comment"> * purpose with or without fee is hereby granted.</span></div>
<div class="line"><span class="comment"> *</span></div>
<div class="line"><span class="comment"> * THE SOFTWARE IS PROVIDED &quot;AS IS&quot; AND THE AUTHOR DISCLAIMS ALL WARRANTIES</span></div>
<div class="line"><span class="comment"> * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF</span></div>
<div class="line"><span class="comment"> * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY</span></div>
<div class="line"><span class="comment"> * SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES</span></div>
<div class="line"><span class="comment"> * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION</span></div>
<div class="line"><span class="comment"> * OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN</span></div>
<div class="line"><span class="comment"> * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.</span></div>
<div class="line"><span class="comment"> */</span></div>
<div class="line"> </div>
<div class="line"><span class="comment">// Post a status (/api/v1/status) with an attachment (/api/v1/media).</span></div>
<div class="line"> </div>
<div class="line"><span class="preprocessor">#if __has_include(&quot;mastodonpp.hpp&quot;</span>)</div>
<div class="line"><span class="preprocessor"># include &quot;mastodonpp.hpp&quot;</span> <span class="comment">// We&#39;re building mastodonpp.</span></div>
<div class="line"><span class="preprocessor">#else</span></div>
<div class="line"><span class="preprocessor"># include &lt;mastodonpp/mastodonpp.hpp&gt;</span> <span class="comment">// We&#39;re building outside mastodonpp.</span></div>
<div class="line"><span class="preprocessor">#endif</span></div>
<div class="line"> </div>
<div class="line"><span class="preprocessor">#include &lt;iostream&gt;</span></div>
<div class="line"><span class="preprocessor">#include &lt;string&gt;</span></div>
<div class="line"><span class="preprocessor">#include &lt;string_view&gt;</span></div>
<div class="line"><span class="preprocessor">#include &lt;vector&gt;</span></div>
<div class="line"> </div>
<div class="line"><span class="keyword">namespace </span>masto = <a class="code" href="namespacemastodonpp.html">mastodonpp</a>;</div>
<div class="line"><span class="keyword">using</span> std::cerr;</div>
<div class="line"><span class="keyword">using</span> std::cout;</div>
<div class="line"><span class="keyword">using</span> std::endl;</div>
<div class="line"><span class="keyword">using</span> std::string;</div>
<div class="line"><span class="keyword">using</span> std::string_view;</div>
<div class="line"><span class="keyword">using</span> std::to_string;</div>
<div class="line"><span class="keyword">using</span> std::vector;</div>
<div class="line"> </div>
<div class="line"><span class="keywordtype">int</span> main(<span class="keywordtype">int</span> argc, <span class="keywordtype">char</span> *argv[])</div>
<div class="line">{</div>
<div class="line"> <span class="keyword">const</span> vector&lt;string_view&gt; args(argv, argv + argc);</div>
<div class="line"> <span class="keywordflow">if</span> (args.size() &lt;= 3)</div>
<div class="line"> {</div>
<div class="line"> cerr &lt;&lt; <span class="stringliteral">&quot;Usage: &quot;</span> &lt;&lt; args[0]</div>
<div class="line"> &lt;&lt; <span class="stringliteral">&quot; &lt;instance hostname&gt; &lt;access token&gt; &lt;file&gt;\n&quot;</span>;</div>
<div class="line"> <span class="keywordflow">return</span> 1;</div>
<div class="line"> }</div>
<div class="line"> </div>
<div class="line"> <span class="keywordflow">try</span></div>
<div class="line"> {</div>
<div class="line"> <span class="comment">// Initialize an Instance and a Connection.</span></div>
<div class="line"> masto::Instance instance{args[1], args[2]};</div>
<div class="line"> masto::Connection connection{instance};</div>
<div class="line"> <span class="keyword">const</span> string_view filename{args[3]};</div>
<div class="line"> </div>
<div class="line"> <span class="comment">// Create attachment.</span></div>
<div class="line"> <span class="keyword">auto</span> answer{connection.post(masto::API::v1::media,</div>
<div class="line"> {{<span class="stringliteral">&quot;file&quot;</span>, string(<span class="stringliteral">&quot;@file:&quot;</span>) += filename},</div>
<div class="line"> {<span class="stringliteral">&quot;description&quot;</span>, <span class="stringliteral">&quot;Test.&quot;</span>}})};</div>
<div class="line"> </div>
<div class="line"> <span class="comment">// Get the ID of the attachment.</span></div>
<div class="line"> <span class="comment">// You normally would use a JSON parser, of course. I don&#39;t use one</span></div>
<div class="line"> <span class="comment">// because I don&#39;t want to add a dependency just for an example.</span></div>
<div class="line"> <span class="keyword">const</span> <span class="keyword">auto</span> pos{answer.body.find(R<span class="stringliteral">&quot;(&quot;id&quot;:&quot;)&quot;) + 6};</span></div>
<div class="line"><span class="stringliteral"> </span><span class="keyword">const</span> <span class="keyword">auto</span> endpos{answer.body.find(R<span class="stringliteral">&quot;(&quot;,)&quot;, pos)};</span></div>
<div class="line"><span class="stringliteral"> </span><span class="keyword">const</span> <span class="keyword">auto</span> media_id{answer.body.substr(pos, endpos - pos)};</div>
<div class="line"> cout &lt;&lt; <span class="stringliteral">&quot;Attachment has ID: &quot;</span> &lt;&lt; media_id &lt;&lt; endl;</div>
<div class="line"> </div>
<div class="line"> <span class="comment">// Post the status. Note that “media_ids” always has to be a vector.</span></div>
<div class="line"> answer = connection.post(masto::API::v1::statuses,</div>
<div class="line"> {{<span class="stringliteral">&quot;status&quot;</span>, <span class="stringliteral">&quot;Attachment test.&quot;</span>},</div>
<div class="line"> {<span class="stringliteral">&quot;media_ids&quot;</span>,</div>
<div class="line"> vector&lt;string_view&gt;{media_id}}});</div>
<div class="line"> <span class="keywordflow">if</span> (answer)</div>
<div class="line"> {</div>
<div class="line"> cout &lt;&lt; <span class="stringliteral">&quot;Successfully posted &quot;</span> &lt;&lt; filename &lt;&lt; <span class="stringliteral">&quot;.\n&quot;</span>;</div>
<div class="line"> }</div>
<div class="line"> <span class="keywordflow">else</span></div>
<div class="line"> {</div>
<div class="line"> <span class="keywordflow">if</span> (answer.curl_error_code == 0)</div>
<div class="line"> {</div>
<div class="line"> <span class="comment">// If it is no libcurl error, it must be an HTTP error.</span></div>
<div class="line"> cerr &lt;&lt; <span class="stringliteral">&quot;HTTP status: &quot;</span> &lt;&lt; answer.http_status &lt;&lt; endl;</div>
<div class="line"> }</div>
<div class="line"> <span class="keywordflow">else</span></div>
<div class="line"> {</div>
<div class="line"> <span class="comment">// Network errors like “Couldn&#39;t resolve host.”.</span></div>
<div class="line"> cerr &lt;&lt; <span class="stringliteral">&quot;libcurl error &quot;</span> &lt;&lt; to_string(answer.curl_error_code)</div>
<div class="line"> &lt;&lt; <span class="stringliteral">&quot;: &quot;</span> &lt;&lt; answer.error_message &lt;&lt; endl;</div>
<div class="line"> }</div>
<div class="line"> }</div>
<div class="line"> }</div>
<div class="line"> <span class="keywordflow">catch</span> (<span class="keyword">const</span> masto::CURLException &amp;e)</div>
<div class="line"> {</div>
<div class="line"> <span class="comment">// Only libcurl errors that are not network errors will be thrown.</span></div>
<div class="line"> <span class="comment">// There went probably something wrong with the initialization.</span></div>
<div class="line"> cerr &lt;&lt; e.what() &lt;&lt; endl;</div>
<div class="line"> }</div>
<div class="line"> </div>
<div class="line"> <span class="keywordflow">return</span> 0;</div>
<div class="line">}</div>
<div class="ttc" id="anamespacemastodonpp_html"><div class="ttname"><a href="namespacemastodonpp.html">mastodonpp</a></div><div class="ttdoc">C++ wrapper for the Mastodon API.</div><div class="ttdef"><b>Definition:</b> api.hpp:25</div></div>
</div><!-- fragment --> </div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated by&#160;<a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.9.1
</small></address>
</body>
</html>