src/api/file_ext_new.c

   1 /* libquvi
   2  * Copyright (C) 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 file_ext_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_file_ext_s.h"
  31
  32 static gpointer _file_ext_new(_quvi_t q)
  33 {
  34   _quvi_file_ext_t qfe = g_new0(struct _quvi_file_ext_s, 1);
  35   qfe->result.file_ext = g_string_new(NULL);
  36   qfe->handle.q = q;
  37   return (qfe);
  38 }
  39
  40 /** @cond NODOC */
  41 extern QuviError l_exec_util_to_file_ext(_quvi_t, const gchar*, GString*);
  42 /** @endcond */
  43
  44 /** @brief Convert content-type to file extension
  45 @return New handle, @ref quvi_file_ext_free it when done using it
  46 @note
  47   - The result is a guess at best and returned by the
  48     util/to_file_ext.lua of libquvi-scripts
  49   - Use @ref quvi_ok for checking if an error occurred
  50 @sa @ref quvi_file_ext_free
  51 @ingroup convenience
  52 */
  53 quvi_file_ext_t quvi_file_ext_new(quvi_t handle, const char *s)
  54 {
  55   _quvi_file_ext_t qfe;
  56   _quvi_t q;
  57
  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(s != NULL, NULL);
  61
  62   qfe = _file_ext_new(handle);
  63   q = (_quvi_t) handle;
  64
  65   q->status.rc = l_exec_util_to_file_ext(q, s, qfe->result.file_ext);
  66
  67   return (qfe);
  68 }
  69
  70 /* vim: set ts=2 sw=2 tw=72 expandtab: */