Update NEWS for v0.9.4
[libquvi.git] / src / api / http_metainfo_new.c
blobe5644dbb778831c2a456dd33cd591dce074294ed
1 /* libquvi
2 * Copyright (C) 2012 Toni Gundogdu <legatvs@gmail.com>
4 * This file is part of libquvi <http://quvi.sourceforge.net/>.
6 * This library is free software: you can redistribute it and/or
7 * modify it under the terms of the GNU Affero General Public
8 * License as published by the Free Software Foundation, either
9 * version 3 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU Affero General Public License for more details.
16 * You should have received a copy of the GNU Affero General
17 * Public License along with this library. If not, see
18 * <http://www.gnu.org/licenses/>.
21 /** @file http_metainfo_new.c */
23 #include "config.h"
25 #include <glib.h>
27 #include "quvi.h"
28 /* -- */
29 #include "_quvi_s.h"
30 #include "_quvi_http_metainfo_s.h"
32 static gpointer _http_metainfo_new(_quvi_t q, const gchar *url)
34 _quvi_http_metainfo_t qv = g_new0(struct _quvi_http_metainfo_s, 1);
35 qv->content_type = g_string_new(NULL);
36 qv->file_ext = g_string_new(NULL);
37 qv->url.input = g_string_new(url);
38 qv->handle.quvi = q;
39 return (qv);
42 /** @cond NODOC */
43 QuviError n_http_metainfo(_quvi_http_metainfo_t);
44 /** @endcond */
46 /** @brief Query meta-info properties for an URL
47 @return New handle, @ref quvi_http_metainfo_free when done using it
48 @note
49 - Support for determining the file extension is very limited
50 - Use @ref quvi_ok for checking if an error occurred
51 @ingroup http_metainfo
53 quvi_http_metainfo_t quvi_http_metainfo_new(quvi_t handle, const char *url)
55 _quvi_http_metainfo_t v;
56 _quvi_t q;
58 /* If G_DISABLE_CHECKS is defined then the check is not performed. */
59 g_return_val_if_fail(handle != NULL, NULL);
60 g_return_val_if_fail(url != NULL, NULL);
62 q = (_quvi_t) handle;
63 v = _http_metainfo_new(q, url);
65 q->status.rc = n_http_metainfo(v);
67 return (v);
70 /* vim: set ts=2 sw=2 tw=72 expandtab: */