<?php

/**

 * SimplePie

 *

 * A PHP-Based RSS and Atom Feed Framework.

 * Takes the hard work out of managing a complete RSS/Atom solution.

 *

 * Copyright (c) 2004-2012, Ryan Parman, Geoffrey Sneddon, Ryan McCue, and contributors

 * All rights reserved.

 *

 * Redistribution and use in source and binary forms, with or without modification, are

 * permitted provided that the following conditions are met:

 *

 * 	* Redistributions of source code must retain the above copyright notice, this list of

 * 	  conditions and the following disclaimer.

 *

 * 	* Redistributions in binary form must reproduce the above copyright notice, this list

 * 	  of conditions and the following disclaimer in the documentation and/or other materials

 * 	  provided with the distribution.

 *

 * 	* Neither the name of the SimplePie Team nor the names of its contributors may be used

 * 	  to endorse or promote products derived from this software without specific prior

 * 	  written permission.

 *

 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS

 * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY

 * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS

 * AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR

 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR

 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY

 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR

 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE

 * POSSIBILITY OF SUCH DAMAGE.

 *

 * @package SimplePie

 * @version 1.3.1

 * @copyright 2004-2012 Ryan Parman, Geoffrey Sneddon, Ryan McCue

 * @author Ryan Parman

 * @author Geoffrey Sneddon

 * @author Ryan McCue

 * @link http://simplepie.org/ SimplePie

 * @license http://www.opensource.org/licenses/bsd-license.php BSD License

 */

/**

 * Handles everything related to enclosures (including Media RSS and iTunes RSS)

 *

 * Used by {@see SimplePie_Item::get_enclosure()} and {@see SimplePie_Item::get_enclosures()}

 *

 * This class can be overloaded with {@see SimplePie::set_enclosure_class()}

 *

 * @package SimplePie

 * @subpackage API

 */

class SimplePie_Enclosure

{

	/**

	 * @var string

	 * @see get_bitrate()

	 */

	var $bitrate;

	/**

	 * @var array

	 * @see get_captions()

	 */

	var $captions;

	/**

	 * @var array

	 * @see get_categories()

	 */

	var $categories;

	/**

	 * @var int

	 * @see get_channels()

	 */

	var $channels;

	/**

	 * @var SimplePie_Copyright

	 * @see get_copyright()

	 */

	var $copyright;

	/**

	 * @var array

	 * @see get_credits()

	 */

	var $credits;

	/**

	 * @var string

	 * @see get_description()

	 */

	var $description;

	/**

	 * @var int

	 * @see get_duration()

	 */

	var $duration;

	/**

	 * @var string

	 * @see get_expression()

	 */

	var $expression;

	/**

	 * @var string

	 * @see get_framerate()

	 */

	var $framerate;

	/**

	 * @var string

	 * @see get_handler()

	 */

	var $handler;

	/**

	 * @var array

	 * @see get_hashes()

	 */

	var $hashes;

	/**

	 * @var string

	 * @see get_height()

	 */

	var $height;

	/**

	 * @deprecated

	 * @var null

	 */

	var $javascript;

	/**

	 * @var array

	 * @see get_keywords()

	 */

	var $keywords;

	/**

	 * @var string

	 * @see get_language()

	 */

	var $lang;

	/**

	 * @var string

	 * @see get_length()

	 */

	var $length;

	/**

	 * @var string

	 * @see get_link()

	 */

	var $link;

	/**

	 * @var string

	 * @see get_medium()

	 */

	var $medium;

	/**

	 * @var string

	 * @see get_player()

	 */

	var $player;

	/**

	 * @var array

	 * @see get_ratings()

	 */

	var $ratings;

	/**

	 * @var array

	 * @see get_restrictions()

	 */

	var $restrictions;

	/**

	 * @var string

	 * @see get_sampling_rate()

	 */

	var $samplingrate;

	/**

	 * @var array

	 * @see get_thumbnails()

	 */

	var $thumbnails;

	/**

	 * @var string

	 * @see get_title()

	 */

	var $title;

	/**

	 * @var string

	 * @see get_type()

	 */

	var $type;

	/**

	 * @var string

	 * @see get_width()

	 */

	var $width;

	/**

	 * Constructor, used to input the data

	 *

	 * For documentation on all the parameters, see the corresponding

	 * properties and their accessors

	 *

	 * @uses idna_convert If available, this will convert an IDN

	 */

	public function __construct($link = null, $type = null, $length = null, $javascript = null, $bitrate = null, $captions = null, $categories = null, $channels = null, $copyright = null, $credits = null, $description = null, $duration = null, $expression = null, $framerate = null, $hashes = null, $height = null, $keywords = null, $lang = null, $medium = null, $player = null, $ratings = null, $restrictions = null, $samplingrate = null, $thumbnails = null, $title = null, $width = null)

	{

		$this->bitrate = $bitrate;

		$this->captions = $captions;

		$this->categories = $categories;

		$this->channels = $channels;

		$this->copyright = $copyright;

		$this->credits = $credits;

		$this->description = $description;

		$this->duration = $duration;

		$this->expression = $expression;

		$this->framerate = $framerate;

		$this->hashes = $hashes;

		$this->height = $height;

		$this->keywords = $keywords;

		$this->lang = $lang;

		$this->length = $length;

		$this->link = $link;

		$this->medium = $medium;

		$this->player = $player;

		$this->ratings = $ratings;

		$this->restrictions = $restrictions;

		$this->samplingrate = $samplingrate;

		$this->thumbnails = $thumbnails;

		$this->title = $title;

		$this->type = $type;

		$this->width = $width;

		if (class_exists('idna_convert'))

		{

			$idn = new idna_convert();

			$parsed = SimplePie_Misc::parse_url($link);

			$this->link = SimplePie_Misc::compress_parse_url($parsed['scheme'], $idn->encode($parsed['authority']), $parsed['path'], $parsed['query'], $parsed['fragment']);

		}

		$this->handler = $this->get_handler(); // Needs to load last

	}

	/**

	 * String-ified version

	 *

	 * @return string

	 */

	public function __toString()

	{

		// There is no $this->data here

		return md5(serialize($this));

	}

	/**

	 * Get the bitrate

	 *

	 * @return string|null

	 */

	public function get_bitrate()

	{

		if ($this->bitrate !== null)

		{

			return $this->bitrate;

		}

		else

		{

			return null;

		}

	}

	/**

	 * Get a single caption

	 *

	 * @param int $key

	 * @return SimplePie_Caption|null

	 */

	public function get_caption($key = 0)

	{

		$captions = $this->get_captions();

		if (isset($captions[$key]))

		{

			return $captions[$key];

		}

		else

		{

			return null;

		}

	}

	/**

	 * Get all captions

	 *

	 * @return array|null Array of {@see SimplePie_Caption} objects

	 */

	public function get_captions()

	{

		if ($this->captions !== null)

		{

			return $this->captions;

		}

		else

		{

			return null;

		}

	}

	/**

	 * Get a single category

	 *

	 * @param int $key

	 * @return SimplePie_Category|null

	 */

	public function get_category($key = 0)

	{

		$categories = $this->get_categories();

		if (isset($categories[$key]))

		{

			return $categories[$key];

		}

		else

		{

			return null;

		}

	}

	/**

	 * Get all categories

	 *

	 * @return array|null Array of {@see SimplePie_Category} objects

	 */

	public function get_categories()

	{

		if ($this->categories !== null)

		{

			return $this->categories;

		}

		else

		{

			return null;

		}

	}

	/**

	 * Get the number of audio channels

	 *

	 * @return int|null

	 */

	public function get_channels()

	{

		if ($this->channels !== null)

		{

			return $this->channels;

		}

		else

		{

			return null;

		}

	}

	/**

	 * Get the copyright information

	 *

	 * @return SimplePie_Copyright|null

	 */

	public function get_copyright()

	{

		if ($this->copyright !== null)

		{

			return $this->copyright;

		}

		else

		{

			return null;

		}

	}

	/**

	 * Get a single credit

	 *

	 * @param int $key

	 * @return SimplePie_Credit|null

	 */

	public function get_credit($key = 0)

	{

		$credits = $this->get_credits();

		if (isset($credits[$key]))

		{

			return $credits[$key];

		}

		else

		{

			return null;

		}

	}

	/**

	 * Get all credits

	 *

	 * @return array|null Array of {@see SimplePie_Credit} objects

	 */

	public function get_credits()

	{

		if ($this->credits !== null)

		{

			return $this->credits;

		}

		else

		{

			return null;

		}

	}

	/**

	 * Get the description of the enclosure

	 *

	 * @return string|null

	 */

	public function get_description()

	{

		if ($this->description !== null)

		{

			return $this->description;

		}

		else

		{

			return null;

		}

	}

	/**

	 * Get the duration of the enclosure

	 *

	 * @param string $convert Convert seconds into hh:mm:ss

	 * @return string|int|null 'hh:mm:ss' string if `$convert` was specified, otherwise integer (or null if none found)

	 */

	public function get_duration($convert = false)

	{

		if ($this->duration !== null)

		{

			if ($convert)

			{

				$time = SimplePie_Misc::time_hms($this->duration);