liblastfm-dev 0.4.0~really0.3.3-0ubuntu1 / usr / include / lastfm / FingerprintId

/*
   Copyright 2009 Last.fm Ltd. 
      - Primarily authored by Max Howell, Jono Cole and Doug Mansell

   This file is part of liblastfm.

   liblastfm 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 3 of the License, or
   (at your option) any later version.

   liblastfm 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 liblastfm.  If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef LASTFM_FINGERPRINT_ID_H
#define LASTFM_FINGERPRINT_ID_H

#include <lastfm/Track>
#include <QMap>
 
namespace lastfm
{
    class LASTFM_DLLEXPORT FingerprintId
    {
        int id;

    public:
        FingerprintId() : id( -1 )
        {}

        FingerprintId( uint i ) : id( i )
        {}

        bool isNull() const { return id == -1; }

        /** we query Last.fm for suggested metadata, how awesome is that? 
          * @returns null if isNull() */
        QNetworkReply* getSuggestions() const;
        static QMap<float,Track> getSuggestions( QNetworkReply* );

        /** -1 if you need to generate it */
        operator int() const { return id; }
        /** isEmpty() if you need to generate it */
        operator QString() const { return id == -1 ? "" : QString::number( id ); }
    };
}


inline QDebug operator<<( QDebug d, lastfm::FingerprintId id)
{
    if (id.isNull())
        return d << "(null)";
    else
        return d << int(id);
}

#endif