src/libFLAC++/metadata.cpp

   1 /* libFLAC++ - Free Lossless Audio Codec library
   2  * Copyright (C) 2002,2003,2004  Josh Coalson
   3  *
   4  * Redistribution and use in source and binary forms, with or without
   5  * modification, are permitted provided that the following conditions
   6  * are met:
   7  *
   8  * - Redistributions of source code must retain the above copyright
   9  * notice, this list of conditions and the following disclaimer.
  10  *
  11  * - Redistributions in binary form must reproduce the above copyright
  12  * notice, this list of conditions and the following disclaimer in the
  13  * documentation and/or other materials provided with the distribution.
  14  *
  15  * - Neither the name of the Xiph.org Foundation nor the names of its
  16  * contributors may be used to endorse or promote products derived from
  17  * this software without specific prior written permission.
  18  *
  19  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  20  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  21  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  22  * A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR
  23  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
  24  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  25  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  26  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
  27  * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
  28  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  29  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  30  */
  31
  32 #include "FLAC++/metadata.h"
  33 #include "FLAC/assert.h"
  34 #include <stdlib.h> // for malloc(), free()
  35 #include <string.h> // for memcpy() etc.
  36
  37 #ifdef _MSC_VER
  38 // warning C4800: 'int' : forcing to bool 'true' or 'false' (performance warning)
  39 #pragma warning ( disable : 4800 )
  40 #endif
  41
  42 namespace FLAC {
  43         namespace Metadata {
  44
  45                 // local utility routines
  46
  47                 namespace local {
  48
  49                         Prototype *construct_block(::FLAC__StreamMetadata *object)
  50                         {
  51                                 Prototype *ret = 0;
  52                                 switch(object->type) {
  53                                         case FLAC__METADATA_TYPE_STREAMINFO:
  54                                                 ret = new StreamInfo(object, /*copy=*/false);
  55                                                 break;
  56                                         case FLAC__METADATA_TYPE_PADDING:
  57                                                 ret = new Padding(object, /*copy=*/false);
  58                                                 break;
  59                                         case FLAC__METADATA_TYPE_APPLICATION:
  60                                                 ret = new Application(object, /*copy=*/false);
  61                                                 break;
  62                                         case FLAC__METADATA_TYPE_SEEKTABLE:
  63                                                 ret = new SeekTable(object, /*copy=*/false);
  64                                                 break;
  65                                         case FLAC__METADATA_TYPE_VORBIS_COMMENT:
  66                                                 ret = new VorbisComment(object, /*copy=*/false);
  67                                                 break;
  68                                         case FLAC__METADATA_TYPE_CUESHEET:
  69                                                 ret = new CueSheet(object, /*copy=*/false);
  70                                                 break;
  71                                         default:
  72                                                 ret = new Unknown(object, /*copy=*/false);
  73                                                 break;
  74                                 }
  75                                 return ret;
  76                         }
  77
  78                 };
  79
  80                 FLACPP_API Prototype *clone(const Prototype *object)
  81                 {
  82                         FLAC__ASSERT(0 != object);
  83
  84                         const StreamInfo *streaminfo = dynamic_cast<const StreamInfo *>(object);
  85                         const Padding *padding = dynamic_cast<const Padding *>(object);
  86                         const Application *application = dynamic_cast<const Application *>(object);
  87                         const SeekTable *seektable = dynamic_cast<const SeekTable *>(object);
  88                         const VorbisComment *vorbiscomment = dynamic_cast<const VorbisComment *>(object);
  89                         const CueSheet *cuesheet = dynamic_cast<const CueSheet *>(object);
  90                         const Unknown *unknown = dynamic_cast<const Unknown *>(object);
  91
  92                         if(0 != streaminfo)
  93                                 return new StreamInfo(*streaminfo);
  94                         else if(0 != padding)
  95                                 return new Padding(*padding);
  96                         else if(0 != application)
  97                                 return new Application(*application);
  98                         else if(0 != seektable)
  99                                 return new SeekTable(*seektable);
 100                         else if(0 != vorbiscomment)
 101                                 return new VorbisComment(*vorbiscomment);
 102                         else if(0 != cuesheet)
 103                                 return new CueSheet(*cuesheet);
 104                         else if(0 != unknown)
 105                                 return new Unknown(*unknown);
 106                         else {
 107                                 FLAC__ASSERT(0);
 108                                 return 0;
 109                         }
 110                 }
 111
 112                 //
 113                 // Prototype
 114                 //
 115
 116                 Prototype::Prototype(const Prototype &object):
 117                 object_(::FLAC__metadata_object_clone(object.object_)),
 118                 is_reference_(false)
 119                 {
 120                         FLAC__ASSERT(object.is_valid());
 121                 }
 122
 123                 Prototype::Prototype(const ::FLAC__StreamMetadata &object):
 124                 object_(::FLAC__metadata_object_clone(&object)),
 125                 is_reference_(false)
 126                 {
 127                 }
 128
 129                 Prototype::Prototype(const ::FLAC__StreamMetadata *object):
 130                 object_(::FLAC__metadata_object_clone(object)),
 131                 is_reference_(false)
 132                 {
 133                         FLAC__ASSERT(0 != object);
 134                 }
 135
 136                 Prototype::Prototype(::FLAC__StreamMetadata *object, bool copy):
 137                 object_(copy? ::FLAC__metadata_object_clone(object) : object),
 138                 is_reference_(false)
 139                 {
 140                         FLAC__ASSERT(0 != object);
 141                 }
 142
 143                 Prototype::~Prototype()
 144                 {
 145                         clear();
 146                 }
 147
 148                 void Prototype::clear()
 149                 {
 150                         if(0 != object_ && !is_reference_)
 151                                 FLAC__metadata_object_delete(object_);
 152                         object_ = 0;
 153                 }
 154
 155                 void Prototype::operator=(const Prototype &object)
 156                 {
 157                         FLAC__ASSERT(object.is_valid());
 158                         clear();
 159                         is_reference_ = false;
 160                         object_ = ::FLAC__metadata_object_clone(object.object_);
 161                 }
 162
 163                 void Prototype::operator=(const ::FLAC__StreamMetadata &object)
 164                 {
 165                         clear();
 166                         is_reference_ = false;
 167                         object_ = ::FLAC__metadata_object_clone(&object);
 168                 }
 169
 170                 void Prototype::operator=(const ::FLAC__StreamMetadata *object)
 171                 {
 172                         FLAC__ASSERT(0 != object);
 173                         clear();
 174                         is_reference_ = false;
 175                         object_ = ::FLAC__metadata_object_clone(object);
 176                 }
 177
 178                 bool Prototype::get_is_last() const
 179                 {
 180                         FLAC__ASSERT(is_valid());
 181                         return (bool)object_->is_last;
 182                 }
 183
 184                 FLAC__MetadataType Prototype::get_type() const
 185                 {
 186                         FLAC__ASSERT(is_valid());
 187                         return object_->type;
 188                 }
 189
 190                 unsigned Prototype::get_length() const
 191                 {
 192                         FLAC__ASSERT(is_valid());
 193                         return object_->length;
 194                 }
 195
 196                 void Prototype::set_is_last(bool value)
 197                 {
 198                         FLAC__ASSERT(is_valid());
 199                         object_->is_last = value;
 200                 }
 201
 202
 203                 //
 204                 // StreamInfo
 205                 //
 206
 207                 StreamInfo::StreamInfo():
 208                 Prototype(FLAC__metadata_object_new(FLAC__METADATA_TYPE_STREAMINFO), /*copy=*/false)
 209                 { }
 210
 211                 StreamInfo::~StreamInfo()
 212                 { }
 213
 214                 unsigned StreamInfo::get_min_blocksize() const
 215                 {
 216                         FLAC__ASSERT(is_valid());
 217                         return object_->data.stream_info.min_blocksize;
 218                 }
 219
 220                 unsigned StreamInfo::get_max_blocksize() const
 221                 {
 222                         FLAC__ASSERT(is_valid());
 223                         return object_->data.stream_info.max_blocksize;
 224                 }
 225
 226                 unsigned StreamInfo::get_min_framesize() const
 227                 {
 228                         FLAC__ASSERT(is_valid());
 229                         return object_->data.stream_info.min_framesize;
 230                 }
 231
 232                 unsigned StreamInfo::get_max_framesize() const
 233                 {
 234                         FLAC__ASSERT(is_valid());
 235                         return object_->data.stream_info.max_framesize;
 236                 }
 237
 238                 unsigned StreamInfo::get_sample_rate() const
 239                 {
 240                         FLAC__ASSERT(is_valid());
 241                         return object_->data.stream_info.sample_rate;
 242                 }
 243
 244                 unsigned StreamInfo::get_channels() const
 245                 {
 246                         FLAC__ASSERT(is_valid());
 247                         return object_->data.stream_info.channels;
 248                 }
 249
 250                 unsigned StreamInfo::get_bits_per_sample() const
 251                 {
 252                         FLAC__ASSERT(is_valid());
 253                         return object_->data.stream_info.bits_per_sample;
 254                 }
 255
 256                 FLAC__uint64 StreamInfo::get_total_samples() const
 257                 {
 258                         FLAC__ASSERT(is_valid());
 259                         return object_->data.stream_info.total_samples;
 260                 }
 261
 262                 const FLAC__byte *StreamInfo::get_md5sum() const
 263                 {
 264                         FLAC__ASSERT(is_valid());
 265                         return object_->data.stream_info.md5sum;
 266                 }
 267
 268                 void StreamInfo::set_min_blocksize(unsigned value)
 269                 {
 270                         FLAC__ASSERT(is_valid());
 271                         FLAC__ASSERT(value >= FLAC__MIN_BLOCK_SIZE);
 272                         FLAC__ASSERT(value <= FLAC__MAX_BLOCK_SIZE);
 273                         object_->data.stream_info.min_blocksize = value;
 274                 }
 275
 276                 void StreamInfo::set_max_blocksize(unsigned value)
 277                 {
 278                         FLAC__ASSERT(is_valid());
 279                         FLAC__ASSERT(value >= FLAC__MIN_BLOCK_SIZE);
 280                         FLAC__ASSERT(value <= FLAC__MAX_BLOCK_SIZE);
 281                         object_->data.stream_info.max_blocksize = value;
 282                 }
 283
 284                 void StreamInfo::set_min_framesize(unsigned value)
 285                 {
 286                         FLAC__ASSERT(is_valid());
 287                         FLAC__ASSERT(value < (1u < FLAC__STREAM_METADATA_STREAMINFO_MIN_FRAME_SIZE_LEN));
 288                         object_->data.stream_info.min_framesize = value;
 289                 }
 290
 291                 void StreamInfo::set_max_framesize(unsigned value)
 292                 {
 293                         FLAC__ASSERT(is_valid());
 294                         FLAC__ASSERT(value < (1u < FLAC__STREAM_METADATA_STREAMINFO_MAX_FRAME_SIZE_LEN));
 295                         object_->data.stream_info.max_framesize = value;
 296                 }
 297
 298                 void StreamInfo::set_sample_rate(unsigned value)
 299                 {
 300                         FLAC__ASSERT(is_valid());
 301                         FLAC__ASSERT(FLAC__format_sample_rate_is_valid(value));
 302                         object_->data.stream_info.sample_rate = value;
 303                 }
 304
 305                 void StreamInfo::set_channels(unsigned value)
 306                 {
 307                         FLAC__ASSERT(is_valid());
 308                         FLAC__ASSERT(value > 0);
 309                         FLAC__ASSERT(value <= FLAC__MAX_CHANNELS);
 310                         object_->data.stream_info.channels = value;
 311                 }
 312
 313                 void StreamInfo::set_bits_per_sample(unsigned value)
 314                 {
 315                         FLAC__ASSERT(is_valid());
 316                         FLAC__ASSERT(value >= FLAC__MIN_BITS_PER_SAMPLE);
 317                         FLAC__ASSERT(value <= FLAC__MAX_BITS_PER_SAMPLE);
 318                         object_->data.stream_info.bits_per_sample = value;
 319                 }
 320
 321                 void StreamInfo::set_total_samples(FLAC__uint64 value)
 322                 {
 323                         FLAC__ASSERT(is_valid());
 324                         FLAC__ASSERT(value < (1u << FLAC__STREAM_METADATA_STREAMINFO_TOTAL_SAMPLES_LEN));
 325                         object_->data.stream_info.total_samples = value;
 326                 }
 327
 328                 void StreamInfo::set_md5sum(const FLAC__byte value[16])
 329                 {
 330                         FLAC__ASSERT(is_valid());
 331                         FLAC__ASSERT(0 != value);
 332                         memcpy(object_->data.stream_info.md5sum, value, 16);
 333                 }
 334
 335
 336                 //
 337                 // Padding
 338                 //
 339
 340                 Padding::Padding():
 341                 Prototype(FLAC__metadata_object_new(FLAC__METADATA_TYPE_PADDING), /*copy=*/false)
 342                 { }
 343
 344                 Padding::~Padding()
 345                 { }
 346
 347                 void Padding::set_length(unsigned length)
 348                 {
 349                         FLAC__ASSERT(is_valid());
 350                         object_->length = length;
 351                 }
 352
 353
 354                 //
 355                 // Application
 356                 //
 357
 358                 Application::Application():
 359                 Prototype(FLAC__metadata_object_new(FLAC__METADATA_TYPE_APPLICATION), /*copy=*/false)
 360                 { }
 361
 362                 Application::~Application()
 363                 { }
 364
 365                 const FLAC__byte *Application::get_id() const
 366                 {
 367                         FLAC__ASSERT(is_valid());
 368                         return object_->data.application.id;
 369                 }
 370
 371                 const FLAC__byte *Application::get_data() const
 372                 {
 373                         FLAC__ASSERT(is_valid());
 374                         return object_->data.application.data;
 375                 }
 376
 377                 void Application::set_id(const FLAC__byte value[4])
 378                 {
 379                         FLAC__ASSERT(is_valid());
 380                         FLAC__ASSERT(0 != value);
 381                         memcpy(object_->data.application.id, value, 4);
 382                 }
 383
 384                 bool Application::set_data(const FLAC__byte *data, unsigned length)
 385                 {
 386                         FLAC__ASSERT(is_valid());
 387                         return (bool)::FLAC__metadata_object_application_set_data(object_, (FLAC__byte*)data, length, true);
 388                 }
 389
 390                 bool Application::set_data(FLAC__byte *data, unsigned length, bool copy)
 391                 {
 392                         FLAC__ASSERT(is_valid());
 393                         return (bool)::FLAC__metadata_object_application_set_data(object_, data, length, copy);
 394                 }
 395
 396
 397                 //
 398                 // SeekTable
 399                 //
 400
 401                 SeekTable::SeekTable():
 402                 Prototype(FLAC__metadata_object_new(FLAC__METADATA_TYPE_SEEKTABLE), /*copy=*/false)
 403                 { }
 404
 405                 SeekTable::~SeekTable()
 406                 { }
 407
 408                 unsigned SeekTable::get_num_points() const
 409                 {
 410                         FLAC__ASSERT(is_valid());
 411                         return object_->data.seek_table.num_points;
 412                 }
 413
 414                 ::FLAC__StreamMetadata_SeekPoint SeekTable::get_point(unsigned index) const
 415                 {
 416                         FLAC__ASSERT(is_valid());
 417                         FLAC__ASSERT(index < object_->data.seek_table.num_points);
 418                         return object_->data.seek_table.points[index];
 419                 }
 420
 421                 void SeekTable::set_point(unsigned index, const ::FLAC__StreamMetadata_SeekPoint &point)
 422                 {
 423                         FLAC__ASSERT(is_valid());
 424                         FLAC__ASSERT(index < object_->data.seek_table.num_points);
 425                         ::FLAC__metadata_object_seektable_set_point(object_, index, point);
 426                 }
 427
 428                 bool SeekTable::insert_point(unsigned index, const ::FLAC__StreamMetadata_SeekPoint &point)
 429                 {
 430                         FLAC__ASSERT(is_valid());
 431                         FLAC__ASSERT(index <= object_->data.seek_table.num_points);
 432                         return (bool)::FLAC__metadata_object_seektable_insert_point(object_, index, point);
 433                 }
 434
 435                 bool SeekTable::delete_point(unsigned index)
 436                 {
 437                         FLAC__ASSERT(is_valid());
 438                         FLAC__ASSERT(index < object_->data.seek_table.num_points);
 439                         return (bool)::FLAC__metadata_object_seektable_delete_point(object_, index);
 440                 }
 441
 442                 bool SeekTable::is_legal() const
 443                 {
 444                         FLAC__ASSERT(is_valid());
 445                         return (bool)::FLAC__metadata_object_seektable_is_legal(object_);
 446                 }
 447
 448
 449                 //
 450                 // VorbisComment::Entry
 451                 //
 452
 453                 VorbisComment::Entry::Entry()
 454                 {
 455                         zero();
 456                 }
 457
 458                 VorbisComment::Entry::Entry(const char *field, unsigned field_length)
 459                 {
 460                         zero();
 461                         construct(field, field_length);
 462                 }
 463
 464                 VorbisComment::Entry::Entry(const char *field)
 465                 {
 466                         zero();
 467                         construct(field);
 468                 }
 469
 470                 VorbisComment::Entry::Entry(const char *field_name, const char *field_value, unsigned field_value_length)
 471                 {
 472                         zero();
 473                         construct(field_name, field_value, field_value_length);
 474                 }
 475
 476                 VorbisComment::Entry::Entry(const char *field_name, const char *field_value)
 477                 {
 478                         zero();
 479                         construct(field_name, field_value);
 480                 }
 481
 482                 VorbisComment::Entry::Entry(const Entry &entry)
 483                 {
 484                         FLAC__ASSERT(entry.is_valid());
 485                         zero();
 486                         construct((const char *)entry.entry_.entry, entry.entry_.length);
 487                 }
 488
 489                 void VorbisComment::Entry::operator=(const Entry &entry)
 490                 {
 491                         FLAC__ASSERT(entry.is_valid());
 492                         clear();
 493                         construct((const char *)entry.entry_.entry, entry.entry_.length);
 494                 }
 495
 496                 VorbisComment::Entry::~Entry()
 497                 {
 498                         clear();
 499                 }
 500
 501                 bool VorbisComment::Entry::is_valid() const
 502                 {
 503                         return is_valid_;
 504                 }
 505
 506                 unsigned VorbisComment::Entry::get_field_length() const
 507                 {
 508                         FLAC__ASSERT(is_valid());
 509                         return entry_.length;
 510                 }
 511
 512                 unsigned VorbisComment::Entry::get_field_name_length() const
 513                 {
 514                         FLAC__ASSERT(is_valid());
 515                         return field_name_length_;
 516                 }
 517
 518                 unsigned VorbisComment::Entry::get_field_value_length() const
 519                 {
 520                         FLAC__ASSERT(is_valid());
 521                         return field_value_length_;
 522                 }
 523
 524                 ::FLAC__StreamMetadata_VorbisComment_Entry VorbisComment::Entry::get_entry() const
 525                 {
 526                         FLAC__ASSERT(is_valid());
 527                         return entry_;
 528                 }
 529
 530                 const char *VorbisComment::Entry::get_field() const
 531                 {
 532                         FLAC__ASSERT(is_valid());
 533                         return (const char *)entry_.entry;
 534                 }
 535
 536                 const char *VorbisComment::Entry::get_field_name() const
 537                 {
 538                         FLAC__ASSERT(is_valid());
 539                         return field_name_;
 540                 }
 541
 542                 const char *VorbisComment::Entry::get_field_value() const
 543                 {
 544                         FLAC__ASSERT(is_valid());
 545                         return field_value_;
 546                 }
 547
 548                 bool VorbisComment::Entry::set_field(const char *field, unsigned field_length)
 549                 {
 550                         FLAC__ASSERT(is_valid());
 551                         FLAC__ASSERT(0 != field);
 552
 553                         clear_entry();
 554
 555                         if(0 == (entry_.entry = (FLAC__byte*)malloc(field_length+1))) {
 556                                 is_valid_ = false;
 557                         }
 558                         else {
 559                                 entry_.length = field_length;
 560                                 memcpy(entry_.entry, field, field_length);
 561                                 entry_.entry[field_length] = '\0';
 562                                 (void) parse_field();
 563                         }
 564
 565                         return is_valid_;
 566                 }
 567
 568                 bool VorbisComment::Entry::set_field(const char *field)
 569                 {
 570                         return set_field(field, strlen(field));
 571                 }
 572
 573                 bool VorbisComment::Entry::set_field_name(const char *field_name)
 574                 {
 575                         FLAC__ASSERT(is_valid());
 576                         FLAC__ASSERT(0 != field_name);
 577
 578                         clear_field_name();
 579
 580                         if(0 == (field_name_ = strdup(field_name))) {
 581                                 is_valid_ = false;
 582                         }
 583                         else {
 584                                 field_name_length_ = strlen(field_name_);
 585                                 compose_field();
 586                         }
 587
 588                         return is_valid_;
 589                 }
 590
 591                 bool VorbisComment::Entry::set_field_value(const char *field_value, unsigned field_value_length)
 592                 {
 593                         FLAC__ASSERT(is_valid());
 594                         FLAC__ASSERT(0 != field_value);
 595
 596                         clear_field_value();
 597
 598                         if(0 == (field_value_ = (char *)malloc(field_value_length+1))) {
 599                                 is_valid_ = false;
 600                         }
 601                         else {
 602                                 field_value_length_ = field_value_length;
 603                                 memcpy(field_value_, field_value, field_value_length);
 604                                 field_value_[field_value_length] = '\0';
 605                                 compose_field();
 606                         }
 607
 608                         return is_valid_;
 609                 }
 610
 611                 bool VorbisComment::Entry::set_field_value(const char *field_value)
 612                 {
 613                         return set_field_value(field_value, strlen(field_value));
 614                 }
 615
 616                 void VorbisComment::Entry::zero()
 617                 {
 618                         is_valid_ = true;
 619                         entry_.length = 0;
 620                         entry_.entry = 0;
 621                         field_name_ = 0;
 622                         field_name_length_ = 0;
 623                         field_value_ = 0;
 624                         field_value_length_ = 0;
 625                 }
 626
 627                 void VorbisComment::Entry::clear()
 628                 {
 629                         clear_entry();
 630                         clear_field_name();
 631                         clear_field_value();
 632                         is_valid_ = true;
 633                 }
 634
 635                 void VorbisComment::Entry::clear_entry()
 636                 {
 637                         if(0 != entry_.entry) {
 638                                 free(entry_.entry);
 639                                 entry_.entry = 0;
 640                                 entry_.length = 0;
 641                         }
 642                 }
 643
 644                 void VorbisComment::Entry::clear_field_name()
 645                 {
 646                         if(0 != field_name_) {
 647                                 free(field_name_);
 648                                 field_name_ = 0;
 649                                 field_name_length_ = 0;
 650                         }
 651                 }
 652
 653                 void VorbisComment::Entry::clear_field_value()
 654                 {
 655                         if(0 != field_value_) {
 656                                 free(field_value_);
 657                                 field_value_ = 0;
 658                                 field_value_length_ = 0;
 659                         }
 660                 }
 661
 662                 void VorbisComment::Entry::construct(const char *field, unsigned field_length)
 663                 {
 664                         if(set_field(field, field_length))
 665                                 parse_field();
 666                 }
 667
 668                 void VorbisComment::Entry::construct(const char *field)
 669                 {
 670                         construct(field, strlen(field));
 671                 }
 672
 673                 void VorbisComment::Entry::construct(const char *field_name, const char *field_value, unsigned field_value_length)
 674                 {
 675                         if(set_field_name(field_name) && set_field_value(field_value, field_value_length))
 676                                 compose_field();
 677                 }
 678
 679                 void VorbisComment::Entry::construct(const char *field_name, const char *field_value)
 680                 {
 681                         construct(field_name, field_value, strlen(field_value));
 682                 }
 683
 684                 void VorbisComment::Entry::compose_field()
 685                 {
 686                         clear_entry();
 687
 688                         if(0 == (entry_.entry = (FLAC__byte*)malloc(field_name_length_ + 1 + field_value_length_ + 1))) {
 689                                 is_valid_ = false;
 690                         }
 691                         else {
 692                                 memcpy(entry_.entry, field_name_, field_name_length_);
 693                                 entry_.length += field_name_length_;
 694                                 memcpy(entry_.entry + entry_.length, "=", 1);
 695                                 entry_.length += 1;
 696                                 memcpy(entry_.entry + entry_.length, field_value_, field_value_length_);
 697                                 entry_.length += field_value_length_;
 698                                 entry_.entry[entry_.length] = '\0';
 699                                 is_valid_ = true;
 700                         }
 701                 }
 702
 703                 void VorbisComment::Entry::parse_field()
 704                 {
 705                         clear_field_name();
 706                         clear_field_value();
 707
 708                         const char *p = (const char *)memchr(entry_.entry, '=', entry_.length);
 709
 710                         if(0 == p)
 711                                 p = (const char *)entry_.entry + entry_.length;
 712
 713                         field_name_length_ = p - (const char *)entry_.entry;
 714                         if(0 == (field_name_ = (char *)malloc(field_name_length_ + 1))) { // +1 for the trailing \0
 715                                 is_valid_ = false;
 716                                 return;
 717                         }
 718                         memcpy(field_name_, entry_.entry, field_name_length_);
 719                         field_name_[field_name_length_] = '\0';
 720
 721                         if(entry_.length - field_name_length_ == 0) {
 722                                 field_value_length_ = 0;
 723                                 if(0 == (field_value_ = (char *)malloc(0))) {
 724                                         is_valid_ = false;
 725                                         return;
 726                                 }
 727                         }
 728                         else {
 729                                 field_value_length_ = entry_.length - field_name_length_ - 1;
 730                                 if(0 == (field_value_ = (char *)malloc(field_value_length_ + 1))) { // +1 for the trailing \0
 731                                         is_valid_ = false;
 732                                         return;
 733                                 }
 734                                 memcpy(field_value_, ++p, field_value_length_);
 735                                 field_value_[field_value_length_] = '\0';
 736                         }
 737
 738                         is_valid_ = true;
 739                 }
 740
 741
 742                 //
 743                 // VorbisComment
 744                 //
 745
 746                 VorbisComment::VorbisComment():
 747                 Prototype(FLAC__metadata_object_new(FLAC__METADATA_TYPE_VORBIS_COMMENT), /*copy=*/false)
 748                 { }
 749
 750                 VorbisComment::~VorbisComment()
 751                 { }
 752
 753                 unsigned VorbisComment::get_num_comments() const
 754                 {
 755                         FLAC__ASSERT(is_valid());
 756                         return object_->data.vorbis_comment.num_comments;
 757                 }
 758
 759                 VorbisComment::Entry VorbisComment::get_vendor_string() const
 760                 {
 761                         FLAC__ASSERT(is_valid());
 762                         return Entry((const char *)object_->data.vorbis_comment.vendor_string.entry, object_->data.vorbis_comment.vendor_string.length);
 763                 }
 764
 765                 VorbisComment::Entry VorbisComment::get_comment(unsigned index) const
 766                 {
 767                         FLAC__ASSERT(is_valid());
 768                         FLAC__ASSERT(index < object_->data.vorbis_comment.num_comments);
 769                         return Entry((const char *)object_->data.vorbis_comment.comments[index].entry, object_->data.vorbis_comment.comments[index].length);
 770                 }
 771
 772                 bool VorbisComment::set_vendor_string(const VorbisComment::Entry &entry)
 773                 {
 774                         FLAC__ASSERT(is_valid());
 775                         // vendor_string is a special kind of entry
 776                         ::FLAC__StreamMetadata_VorbisComment_Entry vendor_string;
 777                         vendor_string.length = entry.get_field_name_length();
 778                         vendor_string.entry = (FLAC__byte*)entry.get_field_name(); // we can cheat on const-ness because we make a copy below:
 779                         return (bool)::FLAC__metadata_object_vorbiscomment_set_vendor_string(object_, vendor_string, /*copy=*/true);
 780                 }
 781
 782                 bool VorbisComment::set_comment(unsigned index, const VorbisComment::Entry &entry)
 783                 {
 784                         FLAC__ASSERT(is_valid());
 785                         FLAC__ASSERT(index < object_->data.vorbis_comment.num_comments);
 786                         return (bool)::FLAC__metadata_object_vorbiscomment_set_comment(object_, index, entry.get_entry(), /*copy=*/true);
 787                 }
 788
 789                 bool VorbisComment::insert_comment(unsigned index, const VorbisComment::Entry &entry)
 790                 {
 791                         FLAC__ASSERT(is_valid());
 792                         FLAC__ASSERT(index <= object_->data.vorbis_comment.num_comments);
 793                         return (bool)::FLAC__metadata_object_vorbiscomment_insert_comment(object_, index, entry.get_entry(), /*copy=*/true);
 794                 }
 795
 796                 bool VorbisComment::append_comment(const VorbisComment::Entry &entry)
 797                 {
 798                         FLAC__ASSERT(is_valid());
 799                         return (bool)::FLAC__metadata_object_vorbiscomment_append_comment(object_, entry.get_entry(), /*copy=*/true);
 800                 }
 801
 802                 bool VorbisComment::delete_comment(unsigned index)
 803                 {
 804                         FLAC__ASSERT(is_valid());
 805                         FLAC__ASSERT(index < object_->data.vorbis_comment.num_comments);
 806                         return (bool)::FLAC__metadata_object_vorbiscomment_delete_comment(object_, index);
 807                 }
 808
 809
 810                 //
 811                 // CueSheet::Track
 812                 //
 813
 814                 CueSheet::Track::Track():
 815                 object_(::FLAC__metadata_object_cuesheet_track_new())
 816                 { }
 817
 818                 CueSheet::Track::Track(const ::FLAC__StreamMetadata_CueSheet_Track *track):
 819                 object_(::FLAC__metadata_object_cuesheet_track_clone(track))
 820                 { }
 821
 822                 CueSheet::Track::Track(const Track &track):
 823                 object_(::FLAC__metadata_object_cuesheet_track_clone(track.object_))
 824                 { }
 825
 826                 void CueSheet::Track::operator=(const Track &track)
 827                 {
 828                         if(0 != object_)
 829                                 ::FLAC__metadata_object_cuesheet_track_delete(object_);
 830                         object_ = ::FLAC__metadata_object_cuesheet_track_clone(track.object_);
 831                 }
 832
 833                 CueSheet::Track::~Track()
 834                 {
 835                         if(0 != object_)
 836                                 ::FLAC__metadata_object_cuesheet_track_delete(object_);
 837                 }
 838
 839                 bool CueSheet::Track::is_valid() const
 840                 {
 841                         return(0 != object_);
 842                 }
 843
 844                 ::FLAC__StreamMetadata_CueSheet_Index CueSheet::Track::get_index(unsigned i) const
 845                 {
 846                         FLAC__ASSERT(is_valid());
 847                         FLAC__ASSERT(i < object_->num_indices);
 848                         return object_->indices[i];
 849                 }
 850
 851                 void CueSheet::Track::set_isrc(const char value[12])
 852                 {
 853                         FLAC__ASSERT(is_valid());
 854                         FLAC__ASSERT(0 != value);
 855                         memcpy(object_->isrc, value, 12);
 856                         object_->isrc[12] = '\0';
 857                 }
 858
 859                 void CueSheet::Track::set_type(unsigned value)
 860                 {
 861                         FLAC__ASSERT(is_valid());
 862                         FLAC__ASSERT(value <= 1);
 863                         object_->type = value;
 864                 }
 865
 866                 void CueSheet::Track::set_index(unsigned i, const ::FLAC__StreamMetadata_CueSheet_Index &index)
 867                 {
 868                         FLAC__ASSERT(is_valid());
 869                         FLAC__ASSERT(i < object_->num_indices);
 870                         object_->indices[i] = index;
 871                 }
 872
 873
 874                 //
 875                 // CueSheet
 876                 //
 877
 878                 CueSheet::CueSheet():
 879                 Prototype(FLAC__metadata_object_new(FLAC__METADATA_TYPE_CUESHEET), /*copy=*/false)
 880                 { }
 881
 882                 CueSheet::~CueSheet()
 883                 { }
 884
 885                 const char *CueSheet::get_media_catalog_number() const
 886                 {
 887                         FLAC__ASSERT(is_valid());
 888                         return object_->data.cue_sheet.media_catalog_number;
 889                 }
 890
 891                 FLAC__uint64 CueSheet::get_lead_in() const
 892                 {
 893                         FLAC__ASSERT(is_valid());
 894                         return object_->data.cue_sheet.lead_in;
 895                 }
 896
 897                 bool CueSheet::get_is_cd() const
 898                 {
 899                         FLAC__ASSERT(is_valid());
 900                         return object_->data.cue_sheet.is_cd? true : false;
 901                 }
 902
 903                 unsigned CueSheet::get_num_tracks() const
 904                 {
 905                         FLAC__ASSERT(is_valid());
 906                         return object_->data.cue_sheet.num_tracks;
 907                 }
 908
 909                 CueSheet::Track CueSheet::get_track(unsigned i) const
 910                 {
 911                         FLAC__ASSERT(is_valid());
 912                         FLAC__ASSERT(i < object_->data.cue_sheet.num_tracks);
 913                         return Track(object_->data.cue_sheet.tracks + i);
 914                 }
 915
 916                 void CueSheet::set_media_catalog_number(const char value[128])
 917                 {
 918                         FLAC__ASSERT(is_valid());
 919                         FLAC__ASSERT(0 != value);
 920                         memcpy(object_->data.cue_sheet.media_catalog_number, value, 128);
 921                         object_->data.cue_sheet.media_catalog_number[128] = '\0';
 922                 }
 923
 924                 void CueSheet::set_lead_in(FLAC__uint64 value)
 925                 {
 926                         FLAC__ASSERT(is_valid());
 927                         object_->data.cue_sheet.lead_in = value;
 928                 }
 929
 930                 void CueSheet::set_is_cd(bool value)
 931                 {
 932                         FLAC__ASSERT(is_valid());
 933                         object_->data.cue_sheet.is_cd = value;
 934                 }
 935
 936                 void CueSheet::set_index(unsigned track_num, unsigned index_num, const ::FLAC__StreamMetadata_CueSheet_Index &index)
 937                 {
 938                         FLAC__ASSERT(is_valid());
 939                         FLAC__ASSERT(track_num < object_->data.cue_sheet.num_tracks);
 940                         FLAC__ASSERT(index_num < object_->data.cue_sheet.tracks[track_num].num_indices);
 941                         object_->data.cue_sheet.tracks[track_num].indices[index_num] = index;
 942                 }
 943
 944                 bool CueSheet::insert_index(unsigned track_num, unsigned index_num, const ::FLAC__StreamMetadata_CueSheet_Index &index)
 945                 {
 946                         FLAC__ASSERT(is_valid());
 947                         FLAC__ASSERT(track_num < object_->data.cue_sheet.num_tracks);
 948                         FLAC__ASSERT(index_num <= object_->data.cue_sheet.tracks[track_num].num_indices);
 949                         return (bool)::FLAC__metadata_object_cuesheet_track_insert_index(object_, track_num, index_num, index);
 950                 }
 951
 952                 bool CueSheet::delete_index(unsigned track_num, unsigned index_num)
 953                 {
 954                         FLAC__ASSERT(is_valid());
 955                         FLAC__ASSERT(track_num < object_->data.cue_sheet.num_tracks);
 956                         FLAC__ASSERT(index_num < object_->data.cue_sheet.tracks[track_num].num_indices);
 957                         return (bool)::FLAC__metadata_object_cuesheet_track_delete_index(object_, track_num, index_num);
 958                 }
 959
 960                 bool CueSheet::set_track(unsigned i, const CueSheet::Track &track)
 961                 {
 962                         FLAC__ASSERT(is_valid());
 963                         FLAC__ASSERT(i < object_->data.cue_sheet.num_tracks);
 964                         // We can safely const_cast since copy=true
 965                         return (bool)::FLAC__metadata_object_cuesheet_set_track(object_, i, const_cast< ::FLAC__StreamMetadata_CueSheet_Track*>(track.get_track()), /*copy=*/true);
 966                 }
 967
 968                 bool CueSheet::insert_track(unsigned i, const CueSheet::Track &track)
 969                 {
 970                         FLAC__ASSERT(is_valid());
 971                         FLAC__ASSERT(i <= object_->data.cue_sheet.num_tracks);
 972                         // We can safely const_cast since copy=true
 973                         return (bool)::FLAC__metadata_object_cuesheet_insert_track(object_, i, const_cast< ::FLAC__StreamMetadata_CueSheet_Track*>(track.get_track()), /*copy=*/true);
 974                 }
 975
 976                 bool CueSheet::delete_track(unsigned i)
 977                 {
 978                         FLAC__ASSERT(is_valid());
 979                         FLAC__ASSERT(i < object_->data.cue_sheet.num_tracks);
 980                         return (bool)::FLAC__metadata_object_cuesheet_delete_track(object_, i);
 981                 }
 982
 983                 bool CueSheet::is_legal(bool check_cd_da_subset, const char **violation) const
 984                 {
 985                         FLAC__ASSERT(is_valid());
 986                         return (bool)::FLAC__metadata_object_cuesheet_is_legal(object_, check_cd_da_subset, violation);
 987                 }
 988
 989
 990                 //
 991                 // Unknown
 992                 //
 993
 994                 Unknown::Unknown():
 995                 Prototype(FLAC__metadata_object_new(FLAC__METADATA_TYPE_APPLICATION), /*copy=*/false)
 996                 { }
 997
 998                 Unknown::~Unknown()
 999                 { }
1000
1001                 const FLAC__byte *Unknown::get_data() const
1002                 {
1003                         FLAC__ASSERT(is_valid());
1004                         return object_->data.application.data;
1005                 }
1006
1007                 bool Unknown::set_data(const FLAC__byte *data, unsigned length)
1008                 {
1009                         FLAC__ASSERT(is_valid());
1010                         return (bool)::FLAC__metadata_object_application_set_data(object_, (FLAC__byte*)data, length, true);
1011                 }
1012
1013                 bool Unknown::set_data(FLAC__byte *data, unsigned length, bool copy)
1014                 {
1015                         FLAC__ASSERT(is_valid());
1016                         return (bool)::FLAC__metadata_object_application_set_data(object_, data, length, copy);
1017                 }
1018
1019
1020                 // ============================================================
1021                 //
1022                 //  Level 0
1023                 //
1024                 // ============================================================
1025
1026                 FLACPP_API bool get_streaminfo(const char *filename, StreamInfo &streaminfo)
1027                 {
1028                         FLAC__ASSERT(0 != filename);
1029
1030                         ::FLAC__StreamMetadata object;
1031
1032                         if(::FLAC__metadata_get_streaminfo(filename, &object)) {
1033                                 streaminfo = object;
1034                                 return true;
1035                         }
1036                         else
1037                                 return false;
1038                 }
1039
1040                 FLACPP_API bool get_tags(const char *filename, VorbisComment *&tags)
1041                 {
1042                         FLAC__ASSERT(0 != filename);
1043
1044                         ::FLAC__StreamMetadata *object;
1045
1046                         tags = 0;
1047
1048                         if(::FLAC__metadata_get_tags(filename, &object)) {
1049                                 tags = new VorbisComment(object, /*copy=*/false);
1050                                 return true;
1051                         }
1052                         else
1053                                 return false;
1054                 }
1055
1056
1057                 // ============================================================
1058                 //
1059                 //  Level 1
1060                 //
1061                 // ============================================================
1062
1063                 SimpleIterator::SimpleIterator():
1064                 iterator_(::FLAC__metadata_simple_iterator_new())
1065                 { }
1066
1067                 SimpleIterator::~SimpleIterator()
1068                 {
1069                         clear();
1070                 }
1071
1072                 void SimpleIterator::clear()
1073                 {
1074                         if(0 != iterator_)
1075                                 FLAC__metadata_simple_iterator_delete(iterator_);
1076                         iterator_ = 0;
1077                 }
1078
1079                 bool SimpleIterator::init(const char *filename, bool read_only, bool preserve_file_stats)
1080                 {
1081                         FLAC__ASSERT(0 != filename);
1082                         FLAC__ASSERT(is_valid());
1083                         return (bool)::FLAC__metadata_simple_iterator_init(iterator_, filename, read_only, preserve_file_stats);
1084                 }
1085
1086                 bool SimpleIterator::is_valid() const
1087                 {
1088                         return 0 != iterator_;
1089                 }
1090
1091                 SimpleIterator::Status SimpleIterator::status()
1092                 {
1093                         FLAC__ASSERT(is_valid());
1094                         return Status(::FLAC__metadata_simple_iterator_status(iterator_));
1095                 }
1096
1097                 bool SimpleIterator::is_writable() const
1098                 {
1099                         FLAC__ASSERT(is_valid());
1100                         return (bool)::FLAC__metadata_simple_iterator_is_writable(iterator_);
1101                 }
1102
1103                 bool SimpleIterator::next()
1104                 {
1105                         FLAC__ASSERT(is_valid());
1106                         return (bool)::FLAC__metadata_simple_iterator_next(iterator_);
1107                 }
1108
1109                 bool SimpleIterator::prev()
1110                 {
1111                         FLAC__ASSERT(is_valid());
1112                         return (bool)::FLAC__metadata_simple_iterator_prev(iterator_);
1113                 }
1114
1115                 ::FLAC__MetadataType SimpleIterator::get_block_type() const
1116                 {
1117                         FLAC__ASSERT(is_valid());
1118                         return ::FLAC__metadata_simple_iterator_get_block_type(iterator_);
1119                 }
1120
1121                 Prototype *SimpleIterator::get_block()
1122                 {
1123                         FLAC__ASSERT(is_valid());
1124                         return local::construct_block(::FLAC__metadata_simple_iterator_get_block(iterator_));
1125                 }
1126
1127                 bool SimpleIterator::set_block(Prototype *block, bool use_padding)
1128                 {
1129                         FLAC__ASSERT(0 != block);
1130                         FLAC__ASSERT(is_valid());
1131                         return (bool)::FLAC__metadata_simple_iterator_set_block(iterator_, block->object_, use_padding);
1132                 }
1133
1134                 bool SimpleIterator::insert_block_after(Prototype *block, bool use_padding)
1135                 {
1136                         FLAC__ASSERT(0 != block);
1137                         FLAC__ASSERT(is_valid());
1138                         return (bool)::FLAC__metadata_simple_iterator_insert_block_after(iterator_, block->object_, use_padding);
1139                 }
1140
1141                 bool SimpleIterator::delete_block(bool use_padding)
1142                 {
1143                         FLAC__ASSERT(is_valid());
1144                         return (bool)::FLAC__metadata_simple_iterator_delete_block(iterator_, use_padding);
1145                 }
1146
1147
1148                 // ============================================================
1149                 //
1150                 //  Level 2
1151                 //
1152                 // ============================================================
1153
1154                 Chain::Chain():
1155                 chain_(::FLAC__metadata_chain_new())
1156                 { }
1157
1158                 Chain::~Chain()
1159                 {
1160                         clear();
1161                 }
1162
1163                 void Chain::clear()
1164                 {
1165                         if(0 != chain_)
1166                                 FLAC__metadata_chain_delete(chain_);
1167                         chain_ = 0;
1168                 }
1169
1170                 bool Chain::is_valid() const
1171                 {
1172                         return 0 != chain_;
1173                 }
1174
1175                 Chain::Status Chain::status()
1176                 {
1177                         FLAC__ASSERT(is_valid());
1178                         return Status(::FLAC__metadata_chain_status(chain_));
1179                 }
1180
1181                 bool Chain::read(const char *filename)
1182                 {
1183                         FLAC__ASSERT(0 != filename);
1184                         FLAC__ASSERT(is_valid());
1185                         return (bool)::FLAC__metadata_chain_read(chain_, filename);
1186                 }
1187
1188                 bool Chain::read(FLAC__IOHandle handle, ::FLAC__IOCallbacks callbacks)
1189                 {
1190                         FLAC__ASSERT(is_valid());
1191                         return (bool)::FLAC__metadata_chain_read_with_callbacks(chain_, handle, callbacks);
1192                 }
1193
1194                 bool Chain::check_if_tempfile_needed(bool use_padding)
1195                 {
1196                         FLAC__ASSERT(is_valid());
1197                         return (bool)::FLAC__metadata_chain_check_if_tempfile_needed(chain_, use_padding);
1198                 }
1199
1200                 bool Chain::write(bool use_padding, bool preserve_file_stats)
1201                 {
1202                         FLAC__ASSERT(is_valid());
1203                         return (bool)::FLAC__metadata_chain_write(chain_, use_padding, preserve_file_stats);
1204                 }
1205
1206                 bool Chain::write(bool use_padding, ::FLAC__IOHandle handle, ::FLAC__IOCallbacks callbacks)
1207                 {
1208                         FLAC__ASSERT(is_valid());
1209                         return (bool)::FLAC__metadata_chain_write_with_callbacks(chain_, use_padding, handle, callbacks);
1210                 }
1211
1212                 bool Chain::write(bool use_padding, ::FLAC__IOHandle handle, ::FLAC__IOCallbacks callbacks, ::FLAC__IOHandle temp_handle, ::FLAC__IOCallbacks temp_callbacks)
1213                 {
1214                         FLAC__ASSERT(is_valid());
1215                         return (bool)::FLAC__metadata_chain_write_with_callbacks_and_tempfile(chain_, use_padding, handle, callbacks, temp_handle, temp_callbacks);
1216                 }
1217
1218                 void Chain::merge_padding()
1219                 {
1220                         FLAC__ASSERT(is_valid());
1221                         ::FLAC__metadata_chain_merge_padding(chain_);
1222                 }
1223
1224                 void Chain::sort_padding()
1225                 {
1226                         FLAC__ASSERT(is_valid());
1227                         ::FLAC__metadata_chain_sort_padding(chain_);
1228                 }
1229
1230
1231                 Iterator::Iterator():
1232                 iterator_(::FLAC__metadata_iterator_new())
1233                 { }
1234
1235                 Iterator::~Iterator()
1236                 {
1237                         clear();
1238                 }
1239
1240                 void Iterator::clear()
1241                 {
1242                         if(0 != iterator_)
1243                                 FLAC__metadata_iterator_delete(iterator_);
1244                         iterator_ = 0;
1245                 }
1246
1247                 bool Iterator::is_valid() const
1248                 {
1249                         return 0 != iterator_;
1250                 }
1251
1252                 void Iterator::init(Chain &chain)
1253                 {
1254                         FLAC__ASSERT(is_valid());
1255                         FLAC__ASSERT(chain.is_valid());
1256                         ::FLAC__metadata_iterator_init(iterator_, chain.chain_);
1257                 }
1258
1259                 bool Iterator::next()
1260                 {
1261                         FLAC__ASSERT(is_valid());
1262                         return (bool)::FLAC__metadata_iterator_next(iterator_);
1263                 }
1264
1265                 bool Iterator::prev()
1266                 {
1267                         FLAC__ASSERT(is_valid());
1268                         return (bool)::FLAC__metadata_iterator_prev(iterator_);
1269                 }
1270
1271                 ::FLAC__MetadataType Iterator::get_block_type() const
1272                 {
1273                         FLAC__ASSERT(is_valid());
1274                         return ::FLAC__metadata_iterator_get_block_type(iterator_);
1275                 }
1276
1277                 Prototype *Iterator::get_block()
1278                 {
1279                         FLAC__ASSERT(is_valid());
1280                         Prototype *block = local::construct_block(::FLAC__metadata_iterator_get_block(iterator_));
1281                         if(0 != block)
1282                                 block->set_reference(true);
1283                         return block;
1284                 }
1285
1286                 bool Iterator::set_block(Prototype *block)
1287                 {
1288                         FLAC__ASSERT(0 != block);
1289                         FLAC__ASSERT(is_valid());
1290                         bool ret = (bool)::FLAC__metadata_iterator_set_block(iterator_, block->object_);
1291                         if(ret) {
1292                                 block->set_reference(true);
1293                                 delete block;
1294                         }
1295                         return ret;
1296                 }
1297
1298                 bool Iterator::delete_block(bool replace_with_padding)
1299                 {
1300                         FLAC__ASSERT(is_valid());
1301                         return (bool)::FLAC__metadata_iterator_delete_block(iterator_, replace_with_padding);
1302                 }
1303
1304                 bool Iterator::insert_block_before(Prototype *block)
1305                 {
1306                         FLAC__ASSERT(0 != block);
1307                         FLAC__ASSERT(is_valid());
1308                         bool ret = (bool)::FLAC__metadata_iterator_insert_block_before(iterator_, block->object_);
1309                         if(ret) {
1310                                 block->set_reference(true);
1311                                 delete block;
1312                         }
1313                         return ret;
1314                 }
1315
1316                 bool Iterator::insert_block_after(Prototype *block)
1317                 {
1318                         FLAC__ASSERT(0 != block);
1319                         FLAC__ASSERT(is_valid());
1320                         bool ret = (bool)::FLAC__metadata_iterator_insert_block_after(iterator_, block->object_);
1321                         if(ret) {
1322                                 block->set_reference(true);
1323                                 delete block;
1324                         }
1325                         return ret;
1326                 }
1327
1328         };
1329 };