89 lines
2.3 KiB
C
89 lines
2.3 KiB
C
|
// -*- c++ -*-
|
||
|
|
#ifndef _GLIBMM_QUARK_H
|
||
|
|
#define _GLIBMM_QUARK_H
|
||
|
|
/* $Id$ */
|
||
|
|
|
||
|
|
/* quark.h
|
||
|
|
*
|
||
|
|
* Copyright 2002 The gtkmm Development Team
|
||
|
|
*
|
||
|
|
* 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., 675 Mass Ave, Cambridge, MA 02139, USA.
|
||
|
|
*/
|
||
|
|
|
||
|
|
#include <glib/gquark.h>
|
||
|
|
#include <glibmm/ustring.h>
|
||
|
|
|
||
|
|
|
||
|
|
namespace Glib
|
||
|
|
{
|
||
|
|
|
||
|
|
/** Quarks are unique IDs in Glib for strings for use in
|
||
|
|
* hash table lookups. Each Quark is unique but may change
|
||
|
|
* between runs.
|
||
|
|
*
|
||
|
|
* QueryQuark is a converter class for looking up but not
|
||
|
|
* allocating an ID. An id means the quark lookup failed.
|
||
|
|
*
|
||
|
|
* Quark is used for actions for which the id should live on
|
||
|
|
* While QueryQuark should be used for queries.
|
||
|
|
* ie.
|
||
|
|
* void set_data (const Quark&, void * data);
|
||
|
|
* void* get_data (const QueryQuark&);
|
||
|
|
*/
|
||
|
|
class QueryQuark
|
||
|
|
{
|
||
|
|
public:
|
||
|
|
QueryQuark(const GQuark& q);
|
||
|
|
QueryQuark(const ustring& s);
|
||
|
|
QueryQuark(const char*s);
|
||
|
|
~QueryQuark() {}
|
||
|
|
QueryQuark& operator=(const QueryQuark& q);
|
||
|
|
operator ustring() const;
|
||
|
|
|
||
|
|
operator GQuark() const {return quark_;}
|
||
|
|
GQuark id() const {return quark_;}
|
||
|
|
|
||
|
|
private:
|
||
|
|
GQuark quark_;
|
||
|
|
};
|
||
|
|
|
||
|
|
class Quark: public QueryQuark
|
||
|
|
{
|
||
|
|
public:
|
||
|
|
Quark(const ustring& s);
|
||
|
|
Quark(const char* s);
|
||
|
|
~Quark();
|
||
|
|
};
|
||
|
|
|
||
|
|
/** @relates Glib::QueryQuark */
|
||
|
|
inline bool operator==(const QueryQuark& a, const QueryQuark& b)
|
||
|
|
{ return a.id() == b.id(); }
|
||
|
|
|
||
|
|
/** @relates Glib::QueryQuark */
|
||
|
|
inline bool operator!=(const QueryQuark& a, const QueryQuark& b)
|
||
|
|
{ return a.id() != b.id(); }
|
||
|
|
|
||
|
|
#ifndef DOXYGEN_SHOULD_SKIP_THIS
|
||
|
|
// TODO: Put this somewhere else.
|
||
|
|
// (internal) The quark for C++ wrappers.
|
||
|
|
extern GLIBMM_API GQuark quark_;
|
||
|
|
extern GLIBMM_API GQuark quark_cpp_wrapper_deleted_;
|
||
|
|
#endif
|
||
|
|
|
||
|
|
} /* namespace Glib */
|
||
|
|
|
||
|
|
#endif /* _GLIBMM_QUARK_H */
|
||
|
|
|