/src/Zend/Media/Id3/Language.php

 1<?php
 2/**
 3 * Zend Framework
 4 *
 5 * LICENSE
 6 *
 7 * This source file is subject to the new BSD license that is bundled
 8 * with this package in the file LICENSE.txt.
 9 * It is also available through the world-wide-web at this URL:
10 * http://framework.zend.com/license/new-bsd
11 * If you did not receive a copy of the license and are unable to
12 * obtain it through the world-wide-web, please send an email
13 * to license@zend.com so we can send you a copy immediately.
14 *
15 * @category   Zend
16 * @package    Zend_Media
17 * @subpackage ID3
18 * @copyright  Copyright (c) 2005-2009 Zend Technologies USA Inc. (http://www.zend.com) 
19 * @license    http://framework.zend.com/license/new-bsd     New BSD License
20 * @version    $Id: Language.php 177 2010-03-09 13:13:34Z svollbehr $
21 */
22
23/**
24 * The <var>Zend_Media_Id3_Language</var> interface implies that the
25 * implementing ID3v2 frame supports its content to be given in multiple
26 * languages.
27 *
28 * The three byte language code is used to describe the language of the frame's
29 * content, according to {@link http://www.loc.gov/standards/iso639-2/
30 * ISO-639-2}. The language should be represented in lower case. If the language
31 * is not known the string 'und' should be used.
32 *
33 * @category   Zend
34 * @package    Zend_Media
35 * @subpackage ID3
36 * @author     Sven Vollbehr <sven@vollbehr.eu>
37 * @copyright  Copyright (c) 2005-2009 Zend Technologies USA Inc. (http://www.zend.com) 
38 * @license    http://framework.zend.com/license/new-bsd     New BSD License
39 * @version    $Id: Language.php 177 2010-03-09 13:13:34Z svollbehr $
40 */
41interface Zend_Media_Id3_Language
42{
43    /**
44     * Returns the text language code.
45     *
46     * @return string
47     */
48    public function getLanguage();
49
50    /**
51     * Sets the text language code.
52     *
53     * @param string $language The text language code.
54     */
55    public function setLanguage($language);
56}