1#ifndef TAG_PARSER_TAGVALUE_H
2#define TAG_PARSER_TAGVALUE_H
8#include <c++utilities/chrono/datetime.h>
9#include <c++utilities/chrono/timespan.h>
10#include <c++utilities/conversion/binaryconversion.h>
11#include <c++utilities/misc/flagenumclass.h>
12#include <c++utilities/misc/traits.h>
19#include <unordered_map>
84 bool scaleTo(
TagType targetScale);
86 std::string toString()
const;
87 static Popularity fromString(std::string_view str);
155 explicit TagValue(std::uint64_t value);
161 explicit TagValue(CppUtilities::DateTime value);
162 explicit TagValue(CppUtilities::TimeSpan value);
173 operator bool()
const;
177 bool isEmpty()
const;
179 void clearMetadata();
180 void clearDataAndMetadata();
183 std::string toDisplayString()
const;
187 std::int32_t toInteger()
const;
188 std::uint64_t toUnsignedInteger()
const;
189 int toStandardGenreIndex()
const;
191 CppUtilities::TimeSpan toTimeSpan()
const;
192 CppUtilities::DateTime toDateTime()
const;
195 std::size_t dataSize()
const;
197 const char *dataPointer()
const;
198 std::string_view data()
const;
201 const std::string &mimeType()
const;
202 void setMimeType(std::string_view mimeType);
203 const Locale &locale()
const;
205 void setLocale(
const Locale &locale);
208 bool isLabeledAsReadonly()
const;
209 void setReadonly(
bool readOnly);
210 const std::unordered_map<std::string, std::string> &nativeData()
const;
211 std::unordered_map<std::string, std::string> &nativeData();
214 void convertDataEncodingForTag(
const Tag *tag);
225 void assignInteger(
int value);
226 void assignUnsignedInteger(std::uint64_t value);
227 void assignStandardGenreIndex(
int index);
232 void assignTimeSpan(CppUtilities::TimeSpan value);
233 void assignDateTime(CppUtilities::DateTime value);
234 void assignPopularity(
const Popularity &value);
236 static void stripBom(
const char *&text, std::size_t &length,
TagTextEncoding encoding);
237 static void ensureHostByteOrder(std::u16string &u16str,
TagTextEncoding currentEncoding);
238 template <
typename ContainerType,
239 CppUtilities::Traits::EnableIf<CppUtilities::Traits::IsIteratable<ContainerType>,
240 std::is_same<typename std::add_const<typename std::remove_pointer<typename ContainerType::value_type>::type>::type,
const TagValue>>
244 bool compareData(
const TagValue &other,
bool ignoreCase =
false)
const;
245 static bool compareData(
const std::string &data1,
const std::string &data2,
bool ignoreCase =
false);
246 static bool compareData(
const char *data1, std::size_t size1,
const char *data2, std::size_t size2,
bool ignoreCase =
false);
249 std::unique_ptr<char[]> m_ptr;
252 std::string m_mimeType;
254 std::unordered_map<std::string, std::string> m_nativeData;
294 assignText(text, textSize, textEncoding, convertTo);
308 assignText(text, std::strlen(text), textEncoding, convertTo);
372 , m_encoding(encoding)
380 m_ptr = std::make_unique<char[]>(m_size);
381 std::copy(
data,
data + m_size, m_ptr.get());
400 , m_encoding(encoding)
464inline TagParser::TagValue::operator bool()
const
480 assignText(text.data(), text.size(), textEncoding, convertTo);
494 assignText(text.data(), text.size(), textEncoding, convertTo);
586 return m_ptr ==
nullptr;
599 return m_ptr ==
nullptr || m_size == 0;
655 return std::string_view(m_ptr.get(), m_size);
687 m_descEncoding = encoding;
837 return m_descEncoding;
845template <
typename ContainerType,
846 CppUtilities::Traits::EnableIf<CppUtilities::Traits::IsIteratable<ContainerType>,
847 std::is_same<typename std::add_const<typename std::remove_pointer<typename ContainerType::value_type>::type>::type,
const TagValue>> *>
850 std::vector<std::string> res;
851 res.reserve(values.size());
852 for (
const auto &value : values) {
853 res.emplace_back(CppUtilities::Traits::dereferenceMaybe(value).
toString(encoding));
863 return compareData(m_ptr.get(), m_size, other.m_ptr.get(), other.m_size, ignoreCase);
871 return compareData(data1.data(), data1.size(), data2.data(), data2.size(), ignoreCase);
The PositionInSet class describes the position of an element in a set which consists of a certain num...
constexpr bool isNull() const
Returns an indication whether both the element position and total element count is 0.
The TagValue class wraps values of different types.
bool compareData(const TagValue &other, bool ignoreCase=false) const
Returns whether the raw data of the current instance equals the raw data of other.
void setMimeType(std::string_view mimeType)
Sets the MIME type.
void setFlags(TagValueFlags flags)
Sets the flags.
const std::unordered_map< std::string, std::string > & nativeData() const
Holds tag format specific meta-data for that field which does not fit into any of the other meta-data...
void clearMetadata()
Wipes assigned meta data.
void assignText(const char *text, std::size_t textSize, TagTextEncoding textEncoding=TagTextEncoding::Latin1, TagTextEncoding convertTo=TagTextEncoding::Unspecified)
Assigns a copy of the given text.
const std::string & mimeType() const
Returns the MIME type.
void assignInteger(int value)
Assigns the given integer value.
bool compareTo(const TagValue &other, TagValueComparisionFlags options=TagValueComparisionFlags::None) const
Returns whether both instances are equal.
TagTextEncoding dataEncoding() const
Returns the data encoding.
void assignPosition(PositionInSet value)
Assigns the given PositionInSet value.
void assignData(const char *data, std::size_t length, TagDataType type=TagDataType::Binary, TagTextEncoding encoding=TagTextEncoding::Latin1)
TagValue(TagValue &&other)=default
bool operator==(const TagValue &other) const
Returns whether both instances are equal.
void setDescription(std::string_view value, TagTextEncoding encoding=TagTextEncoding::Latin1)
Sets the description.
TagDataType type() const
Returns the type of the assigned value.
void assignPopularity(const Popularity &value)
Assigns the specified popularity value.
void assignTimeSpan(CppUtilities::TimeSpan value)
Assigns the given TimeSpan value.
static std::vector< std::string > toStrings(const ContainerType &values, TagTextEncoding encoding=TagTextEncoding::Utf8)
Converts the specified values to string using the specified encoding.
void clearDataAndMetadata()
Wipes assigned data including meta data.
void assignData(std::unique_ptr< char[]> &&data, std::size_t length, TagDataType type=TagDataType::Binary, TagTextEncoding encoding=TagTextEncoding::Latin1)
void assignDateTime(CppUtilities::DateTime value)
Assigns the given DateTime value.
bool isLabeledAsReadonly() const
Returns an indication whether the value is labeled as read-only.
TagValueFlags flags() const
Returns the flags.
bool operator!=(const TagValue &other) const
Returns whether both instances are not equal.
~TagValue()
Destroys the TagValue.
std::string_view data() const
Returns the currently assigned raw data.
TagValue & operator=(TagValue &&other)=default
std::size_t dataSize() const
Returns the size of the assigned value in bytes.
std::u16string toWString(TagTextEncoding encoding=TagTextEncoding::Unspecified) const
Converts the value of the current TagValue object to its equivalent std::wstring representation.
TagTextEncoding descriptionEncoding() const
Returns the description encoding.
void assignStandardGenreIndex(int index)
Assigns the given standard genre index to be assigned.
std::string toString(TagTextEncoding encoding=TagTextEncoding::Unspecified) const
Converts the value of the current TagValue object to its equivalent std::string representation.
bool isNull() const
Returns whether no value is assigned at all.
void setLocale(const Locale &locale)
Sets the setLocale.
void setReadonly(bool readOnly)
Sets whether the TagValue is labeled as read-only.
static void stripBom(const char *&text, std::size_t &length, TagTextEncoding encoding)
Strips the byte order mask from the specified text.
void clearData()
Clears the assigned data.
bool isEmpty() const
Returns whether no or an empty value is assigned.
const std::string & description() const
Returns the description.
const Locale & locale() const
Returns the locale.
TagValue()
Constructs an empty TagValue.
char * dataPointer()
Returns a pointer to the raw data assigned to the current instance.
The Tag class is used to store, read and write tag information.
#define TAG_PARSER_EXPORT
Marks the symbol to be exported by the tagparser library.
constexpr TAG_PARSER_EXPORT std::string_view rating()
constexpr TAG_PARSER_EXPORT std::string_view description()
constexpr TAG_PARSER_EXPORT std::string_view playCounter()
Contains all classes and functions of the TagInfo library.
constexpr int characterSize(TagTextEncoding encoding)
Returns the size of one character for the specified encoding in bytes.
TagTextEncoding
Specifies the text encoding.
constexpr bool operator!=(std::uint8_t lhs, FlacMetaDataBlockType type)
constexpr bool operator==(std::uint8_t lhs, FlacMetaDataBlockType type)
TagType
Specifies the tag type.
TagValueComparisionFlags
The TagValueComparisionOption enum specifies options for TagValue::compareTo().
TagValueFlags
Specifies additional flags about the tag value.
TagDataType
Specifies the data type.
CPP_UTILITIES_MARK_FLAG_ENUM_CLASS(TagParser, TagParser::TagCreationFlags)
The Locale struct specifies a language and/or a country using one or more LocaleDetail objects.
std::string user
The user who gave the rating / played the file, e.g. identified by e-mail address.
bool isEmpty() const
Returns whether the Popularity is empty. The scale and zero-values don't count.
bool operator==(const Popularity &other) const
Returns whether two instances are equal.
std::uint64_t playCounter
Play counter specific to the user.
bool scaleTo(TagType targetScale)
Scales the rating from the current scale to targetScale.
Popularity scaled(TagType targetScale) const
Same as Popularity::scaleTo() but returns a new object.
TagType scale
Specifies the scale used for rating by the tag defining that scale.
double rating
The rating on a tag type specific scale.