A abstraction for the string to data encoding in ID3v1 tags. More...
#include <id3v1tag.h>
Public Member Functions | |
StringHandler () | |
virtual String | parse (const ByteVector &data) const |
virtual ByteVector | render (const String &s) const |
Detailed Description
A abstraction for the string to data encoding in ID3v1 tags.
ID3v1 should in theory always contain ISO-8859-1 (Latin1) data. In practice it does not. TagLib by default only supports ISO-8859-1 data in ID3v1 tags.
However by subclassing this class and reimplementing parse() and render() and setting your reimplementation as the default with ID3v1::Tag::setStringHandler() you can define how you would like these transformations to be done.
- Warning
- It is advisable not to write non-ISO-8859-1 data to ID3v1 tags. Please consider disabling the writing of ID3v1 tags in the case that the data is not ISO-8859-1.
- See also
- ID3v1::Tag::setStringHandler()
Constructor & Destructor Documentation
◆ StringHandler()
TagLib::ID3v1::StringHandler::StringHandler | ( | ) |
Member Function Documentation
◆ parse()
|
virtual |
Decode a string from data. The default implementation assumes that data is an ISO-8859-1 (Latin1) character array.
◆ render()
|
virtual |
Encode a ByteVector with the data from s. The default implementation assumes that s is an ISO-8859-1 (Latin1) string. If the string is does not conform to ISO-8859-1, no value is written.
- Warning
- It is recommended that you not override this method, but instead do not write an ID3v1 tag in the case that the data is not ISO-8859-1.
The documentation for this class was generated from the following file: