6 #include "exiv2lib_export.h"
102 using Blob = std::vector<byte>;
111 static const char* typeName(
TypeId typeId);
113 static TypeId typeId(
const std::string& typeName);
115 static size_t typeSize(
TypeId typeId);
142 void alloc(
size_t size);
146 void resize(
size_t size);
152 using iterator = std::vector<byte>::iterator;
153 using const_iterator = std::vector<byte>::const_iterator;
155 iterator begin() noexcept {
156 return pData_.begin();
158 [[nodiscard]] const_iterator cbegin()
const noexcept {
159 return pData_.cbegin();
161 iterator end() noexcept {
164 [[nodiscard]] const_iterator cend()
const noexcept {
168 [[nodiscard]]
size_t size()
const {
169 return pData_.size();
172 [[nodiscard]] uint8_t read_uint8(
size_t offset)
const;
173 void write_uint8(
size_t offset, uint8_t x);
175 [[nodiscard]] uint16_t read_uint16(
size_t offset,
ByteOrder byteOrder)
const;
176 void write_uint16(
size_t offset, uint16_t x,
ByteOrder byteOrder);
178 [[nodiscard]] uint32_t read_uint32(
size_t offset,
ByteOrder byteOrder)
const;
179 void write_uint32(
size_t offset, uint32_t x,
ByteOrder byteOrder);
181 [[nodiscard]] uint64_t read_uint64(
size_t offset,
ByteOrder byteOrder)
const;
182 void write_uint64(
size_t offset, uint64_t x,
ByteOrder byteOrder);
185 int cmpBytes(
size_t offset,
const void* buf,
size_t bufsize)
const;
188 [[nodiscard]]
byte* data(
size_t offset = 0);
191 [[nodiscard]]
const byte* c_data(
size_t offset = 0)
const;
194 [[nodiscard]]
const char* c_str(
size_t offset = 0)
const;
196 [[nodiscard]]
bool empty()
const {
197 return pData_.empty();
201 std::vector<byte> pData_;
228 template <
typename T>
230 if (byteOrder == littleEndian) {
231 return static_cast<byte>(buf.
at(1)) << 8 | static_cast<byte>(buf.
at(0));
233 return static_cast<byte>(buf.
at(0)) << 8 | static_cast<byte>(buf.
at(1));
313 EXIV2API
void hexdump(std::ostream& os,
const byte* buf,
size_t len,
size_t offset = 0);
320 EXIV2API
bool isHex(
const std::string& str,
size_t size = 0,
const std::string& prefix =
"");
327 EXIV2API
int exifTime(
const char* buf, tm* tm);
333 EXIV2API
const char*
exvGettext(
const char* str);
347 EXIV2API int64_t
parseInt64(
const std::string& s,
bool& ok);
361 EXIV2API uint32_t
parseUint32(
const std::string& s,
bool& ok);
375 EXIV2API
float parseFloat(
const std::string& s,
bool& ok);
448 template <
typename T,
typename K,
int N>
449 const T*
find(T (&src)[N],
const K& key) {
450 const T* rc = std::find(src, src + N, key);
451 return rc == src + N ?
nullptr : rc;
455 template <
typename T>
457 std::ostringstream os;
473 template <
typename T>
475 std::istringstream is(s);
477 ok =
static_cast<bool>(is >> tmp);
479 is >> std::skipws >> rest;
497 #endif // #ifndef TYPES_HPP_
Exif SHORT type, 16-bit (2-byte) unsigned integer.
Definition: types.hpp:73
Exif SLONG type, a 32-bit (4-byte) signed (twos-complement) integer.
Definition: types.hpp:79
EXIV2API Rational floatToRationalCast(float f)
Very simple conversion of a float to a Rational.
Definition: types.cpp:607
Slice (= view) for STL containers.
Definition: slice.hpp:421
EXIV2API size_t us2Data(byte *buf, uint16_t s, ByteOrder byteOrder)
Convert an unsigned short to data, write the data to the buffer, return number of bytes written...
Definition: types.cpp:331
Exif SRATIONAL type, two SLONGs: numerator and denominator of a fraction.
Definition: types.hpp:80
ByteOrder
Type to express the byte order (little or big endian)
Definition: types.hpp:34
IPTC time type.
Definition: types.hpp:89
bool stringTo< bool >(const std::string &s, bool &ok)
Specialization of stringTo(const std::string& s, bool& ok) for bool.
Definition: types.cpp:513
TypeId
Exiv2 value type identifiers.
Definition: types.hpp:70
EXIV2API size_t f2Data(byte *buf, float f, ByteOrder byteOrder)
Convert a single precision floating point (IEEE 754 binary32) float to data, write the data to the bu...
Definition: types.cpp:410
EXIV2API double getDouble(const byte *buf, ByteOrder byteOrder)
Read an 8 byte double precision floating point value (IEEE 754 binary64) from the data buffer...
Definition: types.cpp:308
EXIV2API int64_t parseInt64(const std::string &s, bool &ok)
Return a int64_t set to the value represented by s.
Definition: types.cpp:530
EXIV2API int16_t getShort(const byte *buf, ByteOrder byteOrder)
Read a 2 byte signed short value from the data buffer.
Definition: types.cpp:276
uint8_t byte
1 byte unsigned integer type.
Definition: types.hpp:26
Invalid type id.
Definition: types.hpp:97
MetadataId
An identifier for each type of metadata.
Definition: types.hpp:47
std::string toString(const T &arg)
Utility function to convert the argument of any type to a string.
Definition: types.hpp:456
EXIV2API Rational parseRational(const std::string &s, bool &ok)
Return a Rational set to the value represented by s.
Definition: types.cpp:586
Utility class containing a character array. All it does is to take care of memory allocation and dele...
Definition: types.hpp:124
Exif UNDEFINED type, an 8-bit byte that may contain anything.
Definition: types.hpp:77
XMP bag type.
Definition: types.hpp:94
WriteMethod
Type to indicate write method used by TIFF parsers.
Definition: types.hpp:41
Exif LONG type, 32-bit (4-byte) unsigned integer.
Definition: types.hpp:74
const T * find(T(&src)[N], const K &key)
Find an element that matches key in the array src.
Definition: types.hpp:449
TIFF IFD type, 32-bit (4-byte) unsigned integer.
Definition: types.hpp:83
EXIV2API URational getURational(const byte *buf, ByteOrder byteOrder)
Read an 8 byte unsigned rational value from the data buffer.
Definition: types.cpp:270
EXIV2API std::istream & operator>>(std::istream &is, Rational &r)
Input operator for our fake rational.
Definition: types.cpp:234
Exif SBYTE type, an 8-bit signed (twos-complement) integer.
Definition: types.hpp:76
std::pair< int32_t, int32_t > Rational
8 byte signed rational type.
Definition: types.hpp:31
EXIV2API size_t r2Data(byte *buf, Rational l, ByteOrder byteOrder)
Convert a signed rational to data, write the data to the buffer, return number of bytes written...
Definition: types.cpp:404
EXIV2API const char * exvGettext(const char *str)
Translate a string using the gettext framework. This wrapper hides all the implementation details fro...
Definition: types.cpp:504
Exif RATIONAL type, two LONGs: numerator and denominator of a fraction.
Definition: types.hpp:75
EXIV2API int exifTime(const char *buf, tm *tm)
Converts a string in the form "%Y:%m:%d %H:%M:%S", e.g., "2007:05:24 12:31:55" to broken down time fo...
Definition: types.cpp:484
Exif ASCII type, 8-bit byte.
Definition: types.hpp:72
EXIV2API size_t l2Data(byte *buf, int32_t l, ByteOrder byteOrder)
Convert a signed long to data, write the data to the buffer, return number of bytes written...
Definition: types.cpp:389
TIFF DOUBLE type, double precision (8-byte) IEEE format.
Definition: types.hpp:82
TIFF IFD type, 64-bit (8-byte) unsigned integer.
Definition: types.hpp:86
Exif LONG LONG type, 64-bit (8-byte) signed integer.
Definition: types.hpp:85
Exif BYTE type, 8-bit unsigned integer.
Definition: types.hpp:71
Exif SSHORT type, a 16-bit (2-byte) signed (twos-complement) integer.
Definition: types.hpp:78
AccessMode
An identifier for each mode of metadata support.
Definition: types.hpp:57
EXIV2API bool isHex(const std::string &str, size_t size=0, const std::string &prefix="")
Return true if str is a hex number starting with prefix followed by size hex digits, false otherwise. If size is 0, any number of digits is allowed and all are checked.
Definition: types.cpp:475
EXIV2API float parseFloat(const std::string &s, bool &ok)
Return a float set to the value represented by s.
Definition: types.cpp:564
TIFF FLOAT type, single precision (4-byte) IEEE format.
Definition: types.hpp:81
EXIV2API uint32_t parseUint32(const std::string &s, bool &ok)
Return a uint32_t set to the value represented by s.
Definition: types.cpp:556
EXIV2API size_t ur2Data(byte *buf, URational l, ByteOrder byteOrder)
Convert an unsigned rational to data, write the data to the buffer, return number of bytes written...
Definition: types.cpp:372
Slice< T > makeSlice(T &cont, size_t begin, size_t end)
Return a new slice with the given bounds.
Definition: slice.hpp:533
EXIV2API int32_t getLong(const byte *buf, ByteOrder byteOrder)
Read a 4 byte signed long value from the data buffer.
Definition: types.cpp:283
EXIV2API uint32_t getULong(const byte *buf, ByteOrder byteOrder)
Read a 4 byte unsigned long value from the data buffer.
Definition: types.cpp:250
EXIV2API size_t ull2Data(byte *buf, uint64_t l, ByteOrder byteOrder)
Convert an uint64_t to data, write the data to the buffer, return number of bytes written...
Definition: types.cpp:357
XMP text type.
Definition: types.hpp:92
Class CrwImage to access Canon CRW images. References: The Canon RAW (CRW) File Format by Phil Harv...
Definition: asfvideo.hpp:15
T stringTo(const std::string &s, bool &ok)
Utility function to convert a string to a value of type T.
Definition: types.hpp:474
value_type & at(size_t index)
Definition: slice.hpp:174
std::pair< uint32_t, uint32_t > URational
8 byte unsigned rational type.
Definition: types.hpp:29
EXIV2API std::ostream & operator<<(std::ostream &os, const DataSet &dataSet)
Output operator for dataSet.
Definition: datasets.cpp:592
XMP sequence type.
Definition: types.hpp:95
EXIV2API size_t d2Data(byte *buf, double d, ByteOrder byteOrder)
Convert a double precision floating point (IEEE 754 binary64) double to data, write the data to the b...
Definition: types.cpp:422
Exiv2 type for the Exif user comment.
Definition: types.hpp:90
EXIV2API uint64_t getULongLong(const byte *buf, ByteOrder byteOrder)
Read a 8 byte unsigned long value from the data buffer.
Definition: types.cpp:257
IPTC date type.
Definition: types.hpp:88
EXIV2API size_t s2Data(byte *buf, int16_t s, ByteOrder byteOrder)
Convert a signed short to data, write the data to the buffer, return number of bytes written...
Definition: types.cpp:378
XMP language alternative type.
Definition: types.hpp:96
std::vector< byte > Blob
Container for binary data.
Definition: types.hpp:102
EXIV2API Rational getRational(const byte *buf, ByteOrder byteOrder)
Read an 8 byte signed rational value from the data buffer.
Definition: types.cpp:290
Type information lookup functions. Implemented as a static class.
Definition: types.hpp:108
Exiv2 type for a CIFF directory.
Definition: types.hpp:91
Exif LONG LONG type, 64-bit (8-byte) unsigned integer.
Definition: types.hpp:84
XMP alternative type.
Definition: types.hpp:93
EXIV2API size_t ul2Data(byte *buf, uint32_t l, ByteOrder byteOrder)
Convert an unsigned long to data, write the data to the buffer, return number of bytes written...
Definition: types.cpp:342
Last type id.
Definition: types.hpp:98
EXIV2API float getFloat(const byte *buf, ByteOrder byteOrder)
Read a 4 byte single precision floating point value (IEEE 754 binary32) from the data buffer...
Definition: types.cpp:296
EXIV2API uint16_t getUShort(const byte *buf, ByteOrder byteOrder)
Read a 2 byte unsigned short value from the data buffer.
Definition: types.cpp:246
EXIV2API void hexdump(std::ostream &os, const byte *buf, size_t len, size_t offset=0)
Print len bytes from buf in hex and ASCII format to the given stream, prefixed with the position in t...
Definition: types.cpp:454