cddb_site.h

Go to the documentation of this file.

/*
    $Id: cddb_site.h,v 1.3 2005/06/15 16:08:28 airborne Exp $

    Copyright (C) 2005 Kris Verbeeck <airborne@advalvas.be>

    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Library General Public
    License as published by the Free Software Foundation; either
    version 2 of the License, or (at your option) any later version.

    This library 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
    Library General Public License for more details.

    You should have received a copy of the GNU Library General Public
    License along with this library; if not, write to the
    Free Software Foundation, Inc., 59 Temple Place - Suite 330,
    Boston, MA  02111-1307, USA.
*/

#ifndef CDDB_SITE_H
#define CDDB_SITE_H 1

#ifdef __cplusplus
    extern "C" {
#endif


#include "cddb/cddb_error.h"


/* --- type and structure definitions */


typedef enum {
    PROTO_UNKNOWN = 0,          
    PROTO_CDDBP,                
    PROTO_HTTP                  
} cddb_protocol_t;

typedef struct cddb_site_s cddb_site_t;


/* --- construction / destruction */


cddb_site_t *cddb_site_new(void);

cddb_error_t cddb_site_destroy(cddb_site_t *site);

cddb_site_t *cddb_site_clone(cddb_site_t *site);


/* --- setters / getters --- */


cddb_error_t cddb_site_get_address(const cddb_site_t *site,
                                   const char **address, unsigned int *port);

cddb_error_t cddb_site_set_address(cddb_site_t *site,
                                   const char *address, unsigned int port);

cddb_protocol_t cddb_site_get_protocol(const cddb_site_t *site);

cddb_error_t cddb_site_set_protocol(cddb_site_t *site, cddb_protocol_t proto);

cddb_error_t cddb_site_get_query_path(const cddb_site_t *site,
                                      const char **path);

cddb_error_t cddb_site_set_query_path(cddb_site_t *site, const char *path);

cddb_error_t cddb_site_get_submit_path(const cddb_site_t *site,
                                       const char **path);

cddb_error_t cddb_site_set_submit_path(cddb_site_t *site, const char *path);

cddb_error_t cddb_site_get_location(const cddb_site_t *site,
                                    float *latitude, float *longitude);

cddb_error_t cddb_site_set_location(cddb_site_t *site,
                                    float latitude, float longitude);

cddb_error_t cddb_site_get_description(const cddb_site_t *site,
                                       const char **desc);

cddb_error_t cddb_site_set_description(cddb_site_t *site, const char *desc);


/* --- miscellaneous */


int cddb_site_parse(cddb_site_t *site, const char *line);

cddb_error_t cddb_site_print(const cddb_site_t *site);


#ifdef __cplusplus
    }
#endif

#endif /* CDDB_SITE_H */

---