src/api/media_new.c

   1 /* libquvi
   2  * Copyright (C) 2012,2013  Toni Gundogdu <legatvs@gmail.com>
   3  *
   4  * This file is part of libquvi <http://quvi.sourceforge.net/>.
   5  *
   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.
  10  *
  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.
  15  *
  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/>.
  19  */
  20
  21 /** @file media_new.c */
  22
  23 #include "config.h"
  24
  25 #include <glib.h>
  26
  27 #include "quvi.h"
  28 /* -- */
  29 #include "_quvi_s.h"
  30 #include "_quvi_media_s.h"
  31 /* -- */
  32 #include "misc/match_media_script.h"
  33
  34 /** @brief Parse media properties for URL
  35 @return New handle, @ref quvi_media_free it when done using it
  36 @note
  37   - Calling this function restores the current @ref sess_handle to its
  38     initial state (cookies cleared, custom headers cleared, default
  39     user-agent string restored, ...)
  40   - Use @ref quvi_ok for checking if an error occurred
  41 @sa @ref parse_media
  42 @ingroup mediaprop
  43 */
  44 quvi_media_t quvi_media_new(quvi_t handle, const char *url)
  45 {
  46   _quvi_media_t qm;
  47   _quvi_t q;
  48
  49   /* If G_DISABLE_CHECKS is defined then the check is not performed. */
  50   g_return_val_if_fail(handle != NULL, NULL);
  51   g_return_val_if_fail(url != NULL, NULL);
  52
  53   q = (_quvi_t) handle;
  54   qm = NULL;
  55
  56   q->status.rc = m_match_media_script(q, &qm, url, QM_MATCH_MS_PARSE);
  57   return (qm);
  58 }
  59
  60 /* vim: set ts=2 sw=2 tw=72 expandtab: */