Fix docs, add C++ wrapper functions and update ABI dumps

include/FLAC++/decoder.h

@@ -137,12 +137,14 @@ namespace FLAC {
 			virtual bool get_decode_chained_stream() const;                   ///< See FLAC__stream_decoder_get_decode_chained_stream()
 			virtual bool get_md5_checking() const;                            ///< See FLAC__stream_decoder_get_md5_checking()
 			virtual FLAC__uint64 get_total_samples() const;                   ///< See FLAC__stream_decoder_get_total_samples()
+			virtual FLAC__uint64 find_total_samples();			  ///< See FLAC__stream_decoder_find_total_samples()
 			virtual uint32_t get_channels() const;                            ///< See FLAC__stream_decoder_get_channels()
 			virtual ::FLAC__ChannelAssignment get_channel_assignment() const; ///< See FLAC__stream_decoder_get_channel_assignment()
 			virtual uint32_t get_bits_per_sample() const;                     ///< See FLAC__stream_decoder_get_bits_per_sample()
 			virtual uint32_t get_sample_rate() const;                         ///< See FLAC__stream_decoder_get_sample_rate()
 			virtual uint32_t get_blocksize() const;                           ///< See FLAC__stream_decoder_get_blocksize()
 			virtual bool get_decode_position(FLAC__uint64 *position) const;   ///< See FLAC__stream_decoder_get_decode_position()
+			virtual int32_t get_link_lengths(FLAC__uint64 **link_lengths);    ///< See FLAC__stream_decoder_get_link_lengths()
 
 			virtual ::FLAC__StreamDecoderInitStatus init();      ///< Seek FLAC__stream_decoder_init_stream()
 			virtual ::FLAC__StreamDecoderInitStatus init_ogg();  ///< Seek FLAC__stream_decoder_init_ogg_stream()

include/FLAC/all.h

@@ -445,7 +445,7 @@
  * \section porting_1_4_3_to_1_5_0_summary Summary
  *
  * Between FLAC 1.4.3 and FLAC 1.5.0, there have been changes to
- * existing functions and enums:
+ * existing C functions and enums:
  * - the functions FLAC__metadata_get_streaminfo,
  *   FLAC__metadata_get_tags and FLAC__metadata_get_cuesheet can now
  *   read from Ogg FLAC files
@@ -478,6 +478,11 @@
  * - the function FLAC__stream_decoder_find_total_samples was added,
  *   which seeks to the end of a file to find the total number of
  *   samples
+ * - the function FLAC__stream_encoder_set_num_threads and
+ *   FLAC__stream_encoder_get_num_threads have been added, which
+ *   can be used to enable multithreading in the encoder
+ *
+ * For the C++ API, changes are the same, but in C++ nomenclature
  *
  */
 

src/libFLAC++/stream_decoder.cpp

@@ -146,6 +146,12 @@ namespace FLAC {
 			return ::FLAC__stream_decoder_get_total_samples(decoder_);
 		}
 
+		FLAC__uint64 Stream::find_total_samples()
+		{
+			FLAC__ASSERT(is_valid());
+			return ::FLAC__stream_decoder_find_total_samples(decoder_);
+		}
+
 		uint32_t Stream::get_channels() const
 		{
 			FLAC__ASSERT(is_valid());
@@ -182,6 +188,12 @@ namespace FLAC {
 			return ::FLAC__stream_decoder_get_decode_position(decoder_, position);
 		}
 
+		int32_t Stream::get_link_lengths(FLAC__uint64 **link_lengths)
+		{
+			FLAC__ASSERT(is_valid());
+			return ::FLAC__stream_decoder_get_link_lengths(decoder_, link_lengths);
+		}
+
 		::FLAC__StreamDecoderInitStatus Stream::init()
 		{
 			FLAC__ASSERT(is_valid());

src/test_libFLAC++/decoders.cpp

@@ -679,11 +679,20 @@ static bool test_stream_decoder(Layer layer, bool is_ogg, bool is_chained_ogg)
 		FLAC::Decoder::Stream::State state = decoder->get_state();
 		printf("returned state = %u (%s)... OK\n", (uint32_t)((::FLAC__StreamDecoderState)state), state.as_cstring());
 
+		printf("testing get_link_lengths()... ");
+		if(decoder->get_link_lengths(NULL) != FLAC__STREAM_DECODER_GET_LINK_LENGTHS_NOT_INDEXED)
+			return die_s_("returned incorrectly", decoder);
+
 		printf("progress to next chain link with finish_link()... ");
 		if(!decoder->finish_link())
 			return die_s_("returned false", decoder);
 		printf("OK\n");
 	}
+	else {
+		printf("testing get_link_lengths()... ");
+		if(decoder->get_link_lengths(NULL) != FLAC__STREAM_DECODER_GET_LINK_LENGTHS_INVALID)
+			return die_s_("returned incorrectly", decoder);
+	}
 
 	printf("testing get_state()... ");
 	FLAC::Decoder::Stream::State state = decoder->get_state();
@@ -772,6 +781,24 @@ static bool test_stream_decoder(Layer layer, bool is_ogg, bool is_chained_ogg)
 		return die_s_(expect? "returned false" : "returned true", decoder);
 	printf("OK\n");
 
+	if(is_chained_ogg) {
+		FLAC__uint64 *link_lengths;
+		printf("testing get_link_lengths()... ");
+		if(decoder->get_link_lengths(NULL) != 2)
+			return die_s_("returned incorrectly", decoder);
+
+		printf("testing get_link_lengths()... ");
+		if(decoder->get_link_lengths(&link_lengths) != 2)
+			return die_s_("returned incorrectly", decoder);
+		free(link_lengths);
+	}
+	else {
+		printf("testing get_link_lengths()... ");
+		if(decoder->get_link_lengths(NULL) != FLAC__STREAM_DECODER_GET_LINK_LENGTHS_INVALID)
+			return die_s_("returned incorrectly", decoder);
+	}
+
+
 	printf("testing get_channels()... ");
 	{
 		uint32_t channels = decoder->get_channels();