RetroArch/playlist.h

120 lines
3.2 KiB
C

/* RetroArch - A frontend for libretro.
* Copyright (C) 2010-2014 - Hans-Kristian Arntzen
* Copyright (C) 2011-2015 - Daniel De Matteis
* Copyright (C) 2013-2014 - Jason Fetters
*
* RetroArch 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 Found-
* ation, either version 3 of the License, or (at your option) any later version.
*
* RetroArch 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 RetroArch.
* If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef CONTENT_HISTORY_H__
#define CONTENT_HISTORY_H__
#include <stddef.h>
#ifdef __cplusplus
extern "C" {
#endif
typedef struct content_playlist_entry
{
char *path;
char *core_path;
char *core_name;
} content_playlist_entry_t;
typedef struct content_playlist
{
struct content_playlist_entry *entries;
size_t size;
size_t cap;
char *conf_path;
} content_playlist_t;
/**
* content_playlist_init:
* @path : Path to playlist contents file.
* @size : Maximum capacity of playlist size.
*
* Creates and initializes a playlist.
*
* Returns: handle to new playlist if successful, otherwise NULL
**/
content_playlist_t *content_playlist_init(const char *path, size_t size);
/**
* content_playlist_free:
* @playlist : Playlist handle.
*
* Frees playlist handle.
*/
void content_playlist_free(content_playlist_t *playlist);
/**
* content_playlist_clear:
* @playlist : Playlist handle.
*
* Clears all playlist entries in playlist.
**/
void content_playlist_clear(content_playlist_t *playlist);
/**
* content_playlist_size:
* @playlist : Playlist handle.
*
* Gets size of playlist.
* Returns: size of playlist.
**/
size_t content_playlist_size(content_playlist_t *playlist);
/**
* content_playlist_get_index:
* @playlist : Playlist handle.
* @idx : Index of playlist entry.
* @path : Path of playlist entry.
* @core_path : Core path of playlist entry.
* @core_name : Core name of playlist entry.
*
* Gets values of playlist index:
**/
void content_playlist_get_index(content_playlist_t *playlist,
size_t index,
const char **path, const char **core_path,
const char **core_name);
/**
* content_playlist_push:
* @playlist : Playlist handle.
* @path : Path of new playlist entry.
* @core_path : Core path of new playlist entry.
* @core_name : Core name of new playlist entry.
*
* Push entry to top of playlist.
**/
void content_playlist_push(content_playlist_t *playlist,
const char *path, const char *core_path,
const char *core_name);
void content_playlist_get_index_by_path(content_playlist_t *playlist,
const char *search_path,
char **path, char **core_path,
char **core_name);
void content_playlist_write_file(content_playlist_t *playlist);
#ifdef __cplusplus
}
#endif
#endif