gnc-commodity.h

Go to the documentation of this file.

/********************************************************************
 * gnc-commodity.h -- API for tradable commodities (incl. currency) *
 *                                                                  *
 * This program is free software; you can redistribute it and/or    *
 * modify it under the terms of the GNU General Public License as   *
 * published by the Free Software Foundation; either version 2 of   *
 * the License, or (at your option) any later version.              *
 *                                                                  *
 * This program is distributed in the hope that it will be useful,  *
 * but WITHOUT ANY WARRANTY; without even the implied warranty of   *
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the    *
 * GNU General Public License for more details.                     *
 *                                                                  *
 * You should have received a copy of the GNU General Public License*
 * along with this program; if not, contact:                        *
 *                                                                  *
 * Free Software Foundation           Voice:  +1-617-542-5942       *
 * 51 Franklin Street, Fifth Floor    Fax:    +1-617-542-2652       *
 * Boston, MA  02110-1301,  USA       gnu@gnu.org                   *
 *                                                                  *
 *******************************************************************/

#ifndef GNC_COMMODITY_H
#define GNC_COMMODITY_H

typedef struct _GncCommodityClass gnc_commodityClass;
typedef struct _GncCommodityNamespaceClass gnc_commodity_namespaceClass;

#include <glib.h>
#include "gnc-engine.h"

/* --- type macros --- */
#define GNC_TYPE_COMMODITY            (gnc_commodity_get_type ())
#define GNC_COMMODITY(o)              \
     (G_TYPE_CHECK_INSTANCE_CAST ((o), GNC_TYPE_COMMODITY, gnc_commodity))
#define GNC_COMMODITY_CLASS(k)        \
     (G_TYPE_CHECK_CLASS_CAST((k), GNC_TYPE_COMMODITY, gnc_commodityClass))
#define GNC_IS_COMMODITY(o)           \
     (G_TYPE_CHECK_INSTANCE_TYPE ((o), GNC_TYPE_COMMODITY))
#define GNC_IS_COMMODITY_CLASS(k)     \
     (G_TYPE_CHECK_CLASS_TYPE ((k), GNC_TYPE_COMMODITY))
#define GNC_COMMODITY_GET_CLASS(o)    \
     (G_TYPE_INSTANCE_GET_CLASS ((o), GNC_TYPE_COMMODITY, gnc_commodityClass))
GType gnc_commodity_get_type(void);

/* --- type macros --- */
#define GNC_TYPE_COMMODITY_NAMESPACE            (gnc_commodity_namespace_get_type ())
#define GNC_COMMODITY_NAMESPACE(o)              \
     (G_TYPE_CHECK_INSTANCE_CAST ((o), GNC_TYPE_COMMODITY_NAMESPACE, gnc_commodity_namespace))
#define GNC_COMMODITY_NAMESPACE_CLASS(k)        \
     (G_TYPE_CHECK_CLASS_CAST((k), GNC_TYPE_COMMODITY_NAMESPACE, gnc_commodity_namespaceClass))
#define GNC_IS_COMMODITY_NAMESPACE(o)           \
     (G_TYPE_CHECK_INSTANCE_TYPE ((o), GNC_TYPE_COMMODITY_NAMESPACE))
#define GNC_IS_COMMODITY_NAMESPACE_CLASS(k)     \
     (G_TYPE_CHECK_CLASS_TYPE ((k), GNC_TYPE_COMMODITY_NAMESPACE))
#define GNC_COMMODITY_NAMESPACE_GET_CLASS(o)    \
     (G_TYPE_INSTANCE_GET_CLASS ((o), GNC_TYPE_COMMODITY_NAMESPACE, gnc_commodity_namespaceClass))
GType gnc_commodity_namespace_get_type(void);


#define GNC_COMMODITY_TABLE "gnc_commodity_table"

#define GNC_COMMODITY_NS_LEGACY "GNC_LEGACY_CURRENCIES"
/* The ISO define is deprecated in favor of CURRENCY */
#define GNC_COMMODITY_NS_ISO    "ISO4217"
#define GNC_COMMODITY_NS_CURRENCY "CURRENCY"
#define GNC_COMMODITY_NS_NASDAQ "NASDAQ"
#define GNC_COMMODITY_NS_NYSE   "NYSE"
#define GNC_COMMODITY_NS_EUREX  "EUREX"
#define GNC_COMMODITY_NS_MUTUAL "FUND"
#define GNC_COMMODITY_NS_AMEX   "AMEX"
#define GNC_COMMODITY_NS_ASX    "ASX"

typedef GList CommodityList;

typedef enum
{
  SOURCE_SINGLE = 0,    
  SOURCE_MULTI,         
  SOURCE_UNKNOWN,       
  SOURCE_MAX,
  SOURCE_CURRENCY = SOURCE_MAX, 
} QuoteSourceType;

gboolean gnc_quote_source_fq_installed (void);

void gnc_quote_source_set_fq_installed (const GList *sources_list);

gint gnc_quote_source_num_entries(QuoteSourceType type);

gnc_quote_source *gnc_quote_source_add_new(const char * name, gboolean supported);

gnc_quote_source *gnc_quote_source_lookup_by_internal(const char * internal_name);

gnc_quote_source *gnc_quote_source_lookup_by_ti(QuoteSourceType type, gint index);

gboolean gnc_quote_source_get_supported (const gnc_quote_source *source);

QuoteSourceType gnc_quote_source_get_type (const gnc_quote_source *source);

gint gnc_quote_source_get_index (const gnc_quote_source *source);

const char *gnc_quote_source_get_user_name (const gnc_quote_source *source);

const char *gnc_quote_source_get_internal_name (const gnc_quote_source *source);

const char *gnc_quote_source_get_old_internal_name (const gnc_quote_source *source);
gnc_commodity * gnc_commodity_new(QofBook *book,
                                  const char * fullname, 
                                  const char * namespace,
                                  const char * mnemonic,
                                  const char * cusip,
                                  int fraction);

void  gnc_commodity_destroy(gnc_commodity * cm);

void  gnc_commodity_copy(gnc_commodity * dest, const gnc_commodity *src);

gnc_commodity * gnc_commodity_clone(const gnc_commodity *src, QofBook *dest_book);
const char * gnc_commodity_get_mnemonic(const gnc_commodity * cm);

const char * gnc_commodity_get_namespace(const gnc_commodity * cm);

const char * gnc_commodity_get_namespace_compat(const gnc_commodity * cm);

gnc_commodity_namespace *gnc_commodity_get_namespace_ds(const gnc_commodity * cm);

const char * gnc_commodity_get_fullname(const gnc_commodity * cm);

const char * gnc_commodity_get_printname(const gnc_commodity * cm);

const char * gnc_commodity_get_cusip(const gnc_commodity * cm);

const char * gnc_commodity_get_unique_name(const gnc_commodity * cm);

int     gnc_commodity_get_fraction(const gnc_commodity * cm);

gint16  gnc_commodity_get_mark(const gnc_commodity * cm);

gboolean    gnc_commodity_get_quote_flag(const gnc_commodity *cm);

gnc_quote_source* gnc_commodity_get_quote_source(const gnc_commodity *cm);
gnc_quote_source* gnc_commodity_get_default_quote_source(const gnc_commodity *cm);

const char* gnc_commodity_get_quote_tz(const gnc_commodity *cm);
void  gnc_commodity_set_mnemonic(gnc_commodity * cm, const char * mnemonic);

void  gnc_commodity_set_namespace(gnc_commodity * cm, const char * namespace);

void  gnc_commodity_set_fullname(gnc_commodity * cm, const char * fullname);

void  gnc_commodity_set_cusip(gnc_commodity * cm, const char * cusip);

void  gnc_commodity_set_fraction(gnc_commodity * cm, int smallest_fraction);

void  gnc_commodity_user_set_quote_flag(gnc_commodity *cm,
                                        const gboolean flag);

void  gnc_commodity_set_quote_flag(gnc_commodity *cm, const gboolean flag);

void  gnc_commodity_set_quote_source(gnc_commodity *cm, gnc_quote_source *src);

void  gnc_commodity_set_quote_tz(gnc_commodity *cm, const char *tz);
void
gnc_commodity_increment_usage_count(gnc_commodity *cm);

void
gnc_commodity_decrement_usage_count(gnc_commodity *cm);
gboolean gnc_commodity_equiv(const gnc_commodity * a, const gnc_commodity * b);

gboolean gnc_commodity_equal(const gnc_commodity * a, const gnc_commodity * b);
gboolean gnc_commodity_namespace_is_iso(const char *namespace);

gboolean gnc_commodity_is_iso(const gnc_commodity * cm);

gboolean gnc_commodity_is_currency(const gnc_commodity *cm);

/* =============================================================== */
gnc_commodity_table * gnc_commodity_table_get_table(QofBook *book);

/* XXX backwards compat function; remove me someday */
#define gnc_book_get_commodity_table gnc_commodity_table_get_table

gboolean gnc_commodity_table_equal(gnc_commodity_table *t_1,
                                   gnc_commodity_table *t_2);

void gnc_commodity_table_copy(gnc_commodity_table *dest,
                              gnc_commodity_table *src,
                              QofBook *dest_book);
/* ---------------------------------------------------------- */
gnc_commodity * gnc_commodity_table_lookup(const gnc_commodity_table * table, 
                                           const char * namespace, 
                                           const char * mnemonic);
gnc_commodity *
gnc_commodity_table_lookup_unique(const gnc_commodity_table *table,
                                  const char * unique_name);
gnc_commodity * gnc_commodity_table_find_full(const gnc_commodity_table * t,
                                              const char * namespace,
                                              const char * fullname);

gnc_commodity * gnc_commodity_find_commodity_by_guid(const GUID *guid, QofBook *book);
gnc_commodity_namespace * gnc_commodity_find_namespace_by_guid(const GUID *guid, QofBook *book);

/* ---------------------------------------------------------- */

gnc_commodity * gnc_commodity_table_insert(gnc_commodity_table * table,
                                           gnc_commodity * comm);

void gnc_commodity_table_remove(gnc_commodity_table * table,
                                gnc_commodity * comm);

gboolean gnc_commodity_table_add_default_data(gnc_commodity_table *table, QofBook *book);

/* ---------------------------------------------------------- */
const char * gnc_commodity_namespace_get_name (const gnc_commodity_namespace *ns) ;


GList * gnc_commodity_namespace_get_commodity_list(const gnc_commodity_namespace * ns);


guint gnc_commodity_table_get_number_of_namespaces(const gnc_commodity_table* tbl);

int gnc_commodity_table_has_namespace(const gnc_commodity_table * table,
                                      const char * namespace);

GList * gnc_commodity_table_get_namespaces(const gnc_commodity_table * t);

GList * gnc_commodity_table_get_namespaces_list(const gnc_commodity_table * t);

gnc_commodity_namespace * gnc_commodity_table_add_namespace(gnc_commodity_table * table,
                                                            const char * namespace,
                                                            QofBook *book);

gnc_commodity_namespace * gnc_commodity_table_find_namespace(const gnc_commodity_table * table,
                                                             const char * namespace);

void      gnc_commodity_table_delete_namespace(gnc_commodity_table * table,
                                               const char * namespace);
/* ---------------------------------------------------------- */
guint gnc_commodity_table_get_size(const gnc_commodity_table* tbl);

CommodityList * gnc_commodity_table_get_commodities(
    const gnc_commodity_table * table, const char * namespace);

CommodityList * gnc_commodity_table_get_quotable_commodities(
    const gnc_commodity_table * table);

gboolean gnc_commodity_table_foreach_commodity(const gnc_commodity_table * table,
                                       gboolean (*f)(gnc_commodity *cm,
                                                     gpointer user_data),
                                       gpointer user_data);
/* ---------------------------------------------------------- */
void  gnc_commodity_set_mark(gnc_commodity * cm, gint16 mark);

gnc_commodity_table * gnc_commodity_table_new(void);
void          gnc_commodity_table_destroy(gnc_commodity_table * table);

gnc_commodity * gnc_commodity_obtain_twin (const gnc_commodity *from, QofBook *book);

gboolean gnc_commodity_table_register (void);

void gnc_commodity_begin_edit (gnc_commodity *cm);
void gnc_commodity_commit_edit (gnc_commodity *cm);
                  
#endif /* GNC_COMMODITY_H */

---