xaizek / pms (License: GPLv3+) (since 2018-12-07)
Older version of Practical Music Search written in C++.
<root> / src / songlist.h (8f499807f6c8db8611caed9ddf4c3857481562a3) (3,123B) (mode 100644) [raw]
/* vi:set ts=8 sts=8 sw=8 noet:
 *
 * Practical Music Search
 * Copyright (c) 2006-2011  Kim Tore Jensen
 *
 * 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 3 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, see <http://www.gnu.org/licenses/>.
 *
 */

#ifndef _PMS_SONGLIST_H_
#define _PMS_SONGLIST_H_

#include "song.h"
#include "search.h"
#include <string>
#include <vector>

using namespace std;

typedef vector<Song *> *		selection_t;

class Songlist
{
	private:
		unsigned int		poscache;
		unsigned long		lengthcache;
		vector<Song *>		selection;

	public:
		Songlist();
		~Songlist();

		Song *			at(unsigned int spos);
		Song *			operator[] (unsigned int spos) { return at(spos); };

		vector<Song *>		songs;
		unsigned long		songlen;
		string			title;
		Searchresults *		searchresult;
		Searchresults *		livesource;
		vector<Searchresults *> liveresults;
		search_mode_t		searchmode;

		/* Visual and selections */
		vector<unsigned long>	selections; /* hashes of songs that are manually selected */
		size_t			visual_start;
		size_t			visual_stop;
		bool			is_selected(size_t pos);
		selection_t		get_selection();
		void			visual_pos(size_t * start, size_t * stop); /* populate start and stop with real visual start/stop */
		void			clear_visual();

		/* Can we make local modifications? */
		bool			readonly;

		/* Is this the main playlist? */
		bool			playlist;

		/* Playlist version at MPD side */
		long long		version;

		/* Add or replace a song */
		void			add(Song * song);

		/* Remove all songs from the list */
		void			clear();

		/* Get a random song position within boundaries */
		size_t			randpos();

		/* Truncate the list and resize the vector */
		void			truncate(unsigned long length);

		/* Size */
		size_t			size();

		/* Length of all visible songs */
		unsigned long		length();
		unsigned long		length(size_t pos);

		/* Sort the list */
		void			sort(string sortstr);

		/*
		 * Search functions
		 */
		
		/* Find by hash value */
		size_t			find(long hash, size_t pos = 0);

		/* Same as find(), but looks only through search results */
		size_t			sfind(long hash, size_t pos = 0);

		/* Find relative song->pos in search mode, for use in playlist */
		size_t			spos(song_t pos);

		/* Search for songs using song fields. */
		Song *			search(search_mode_t mode);
		Song *			search(search_mode_t mode, long mask, string terms);

		/* Actual search worker, searches through source and returns a result set */
		Searchresults *		search(vector<Song *> * source, long mask, string terms);

		/* Clear live search cache */
		void			liveclear();

};

#endif /* _PMS_SONGLIST_H_ */
Hints

Before first commit, do not forget to setup your git environment:
git config --global user.name "your_name_here"
git config --global user.email "your@email_here"

Clone this repository using HTTP(S):
git clone https://code.reversed.top/user/xaizek/pms

Clone this repository using ssh (do not forget to upload a key first):
git clone ssh://rocketgit@code.reversed.top/user/xaizek/pms

You are allowed to anonymously push to this repository.
This means that your pushed commits will automatically be transformed into a pull request:
... clone the repository ...
... make some changes and some commits ...
git push origin master