This file is indexed.

/usr/include/id3/misc_support.h is in libid3-3.8.3-dev 3.8.3-16.2.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
// -*- C++ -*-
// $Id: misc_support.h,v 1.29 2002/09/19 10:21:57 t1mpy Exp $

// id3lib: a C++ library for creating and manipulating id3v1/v2 tags
// Copyright 1999, 2000  Scott Thomas Haug
// Copyright 2002 Thijmen Klok (thijmen@id3lib.org)

// 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.

// The id3lib authors encourage improvements and optimisations to be sent to
// the id3lib coordinator.  Please see the README file for details on where to
// send such submissions.  See the AUTHORS file for a list of people who have
// contributed to id3lib.  See the ChangeLog file for a list of changes to
// id3lib.  These files are distributed with id3lib at
// http://download.sourceforge.net/id3lib/

#ifndef _ID3LIB_MISC_SUPPORT_H_
#define _ID3LIB_MISC_SUPPORT_H_

#include <id3/tag.h>

ID3_C_EXPORT char*      ID3_GetString(const ID3_Frame *, ID3_FieldID);
ID3_C_EXPORT char*      ID3_GetString(const ID3_Frame *, ID3_FieldID, size_t nItems);

ID3_C_EXPORT void ID3_FreeString(char *str);

// defined in 'id3_misc_support.cpp'
// these are 'convenience functions,' to make using the library easier for the
// most common of operations
ID3_C_EXPORT char*      ID3_GetArtist(const ID3_Tag*);
ID3_C_EXPORT ID3_Frame* ID3_AddArtist(ID3_Tag*, const char*, bool replace = false);
ID3_C_EXPORT size_t     ID3_RemoveArtists(ID3_Tag*);

ID3_C_EXPORT char*      ID3_GetAlbum(const ID3_Tag*);
ID3_C_EXPORT ID3_Frame* ID3_AddAlbum(ID3_Tag*, const char*, bool replace = false);
ID3_C_EXPORT size_t     ID3_RemoveAlbums(ID3_Tag*);

ID3_C_EXPORT char*      ID3_GetTitle(const ID3_Tag*);
ID3_C_EXPORT ID3_Frame* ID3_AddTitle(ID3_Tag*, const char*, bool replace = false);
ID3_C_EXPORT size_t     ID3_RemoveTitles(ID3_Tag*);

ID3_C_EXPORT char*      ID3_GetYear(const ID3_Tag*);
ID3_C_EXPORT ID3_Frame* ID3_AddYear(ID3_Tag*, const char*, bool replace = false);
ID3_C_EXPORT size_t     ID3_RemoveYears(ID3_Tag*);

ID3_C_EXPORT char*      ID3_GetComment(const ID3_Tag*, const char* desc = NULL);
ID3_C_EXPORT ID3_Frame* ID3_AddComment(ID3_Tag*, const char*, bool = false);
ID3_C_EXPORT ID3_Frame* ID3_AddComment(ID3_Tag*, const char*, const char*, bool = false);
ID3_C_EXPORT ID3_Frame* ID3_AddComment(ID3_Tag*, const char*, const char*, const char*,
                                       bool = false);
ID3_C_EXPORT size_t     ID3_RemoveComments(ID3_Tag*, const char * = NULL);

ID3_C_EXPORT char*      ID3_GetTrack(const ID3_Tag*);
ID3_C_EXPORT size_t     ID3_GetTrackNum(const ID3_Tag*);
//following routine courtesy of John George
ID3_C_EXPORT ID3_Frame* ID3_AddTrack(ID3_Tag*, uchar ucTrack, uchar ucTotal = 0,
                                     bool replace = false);
ID3_C_EXPORT size_t     ID3_RemoveTracks(ID3_Tag*);

ID3_C_EXPORT char*      ID3_GetGenre(const ID3_Tag*);
ID3_C_EXPORT size_t     ID3_GetGenreNum(const ID3_Tag*);
ID3_C_EXPORT ID3_Frame* ID3_AddGenre(ID3_Tag*, size_t ucGenre, bool replace = false);
//following routine courtesy of John George
ID3_C_EXPORT ID3_Frame* ID3_AddGenre(ID3_Tag*, const char *, bool replace = false);
ID3_C_EXPORT size_t     ID3_RemoveGenres(ID3_Tag*);

ID3_C_EXPORT char*      ID3_GetLyrics(const ID3_Tag*);
ID3_C_EXPORT ID3_Frame* ID3_AddLyrics(ID3_Tag*, const char*, bool = false);
ID3_C_EXPORT ID3_Frame* ID3_AddLyrics(ID3_Tag*, const char*, const char*, bool = false);
ID3_C_EXPORT ID3_Frame* ID3_AddLyrics(ID3_Tag*, const char*, const char*, const char*,
                                      bool = false);
ID3_C_EXPORT size_t     ID3_RemoveLyrics(ID3_Tag*);

ID3_C_EXPORT char*      ID3_GetLyricist(const ID3_Tag*);
ID3_C_EXPORT ID3_Frame* ID3_AddLyricist(ID3_Tag *, const char *, bool replace = false);
ID3_C_EXPORT size_t     ID3_RemoveLyricist(ID3_Tag*);

ID3_C_EXPORT ID3_Frame* ID3_AddSyncLyrics(ID3_Tag*, const uchar*, size_t,
                                          ID3_TimeStampFormat, bool = false);
ID3_C_EXPORT ID3_Frame* ID3_AddSyncLyrics(ID3_Tag*, const uchar*, size_t,
                                          ID3_TimeStampFormat, const char *, bool = false);
ID3_C_EXPORT ID3_Frame* ID3_AddSyncLyrics(ID3_Tag*, const uchar*, size_t,
                                          ID3_TimeStampFormat, const char *, const char *,
                                          bool = false);
ID3_C_EXPORT ID3_Frame* ID3_AddSyncLyrics(ID3_Tag*, const uchar*, size_t,
                                          ID3_TimeStampFormat, const char *, const char *,
                                          ID3_ContentType, bool = false);
ID3_C_EXPORT ID3_Frame* ID3_GetSyncLyricsInfo(const ID3_Tag *tag, const char *lang,
                                              const char *desc, char &stampformat,
                                              char &type, size_t &size);
ID3_C_EXPORT ID3_Frame* ID3_GetSyncLyrics(const ID3_Tag* tag, const char* lang,
                                          const char* desc, const uchar* &pData, size_t& size);


//following routine courtesy of John George
ID3_C_EXPORT int ID3_GetPictureData(const ID3_Tag*, const char* TempPicPath);

//following routine courtesy of John George
ID3_C_EXPORT char* ID3_GetPictureMimeType(const ID3_Tag*);

//following routine courtesy of John George
ID3_C_EXPORT bool ID3_HasPicture(const ID3_Tag*);

//following two routines courtesy of John George
ID3_C_EXPORT ID3_Frame* ID3_AddPicture(ID3_Tag*, const char* TempPicPath, const char* MimeType, bool replace = false);
ID3_C_EXPORT ID3_Frame* ID3_AddPicture(ID3_Tag*, const char* TempPicPath, const char* MimeType, ID3_PictureType pictype, const char* Description, bool replace = false);

//following routine courtesy of John George
ID3_C_EXPORT size_t ID3_RemovePictures(ID3_Tag*);

//following routine courtesy of John George
ID3_C_EXPORT size_t ID3_GetPictureDataOfPicType(ID3_Tag*, const char* TempPicPath, ID3_PictureType pictype);

//following routine courtesy of John George
ID3_C_EXPORT char *ID3_GetMimeTypeOfPicType(ID3_Tag*, ID3_PictureType pictype);

//following routine courtesy of John George
ID3_C_EXPORT char *ID3_GetDescriptionOfPicType(ID3_Tag*, ID3_PictureType pictype);

//following routine courtesy of John George
ID3_C_EXPORT size_t ID3_RemovePictureType(ID3_Tag*, ID3_PictureType pictype);


#endif /* _ID3LIB_MISC_SUPPORT_H_ */