Source for file lib_languages.php

<?php
/*
 * Lokorin.com
 * Copyright 2004-2006
 * Licensed under the GNU LGPL. See COPYING for full terms.
 */
/**
 * A library that contains everything related to the programming language
 * information system in the site.
 * @author Andreas Launila
 * @version $Revision: 1.10 $
 * @package com.lokorin.lokorin.lib
 * @license http://www.gnu.org/copyleft/lesser.html GNU Lesser General Public License
 */
 
/**
 * For access to common constants and functions.
 */
require_once('common.php');
 
/**
 * Gets all available programming languages.
 * @return array An array of ProgrammingLanguage instances, each instance
 *          represents one of the retrieved programming languages.
 * @access public
 */
function getAllLanguages() {
    global $db;
    
    $rows = $db->querySelect(TABLE_PROGRAM_LANGS, array('id'));
    $langs = array();
    foreach($rows as $row) {
        $langs[] = new ProgrammingLanguage($row['id']);
    }
    return $langs;
}
 
/**
 * Gets the names of all available languages.
 * @return array An array with the names of all languages with the
 *          corresponding unique identifier as key.
 * @access public
 */
function getAllLanguageNames() {
    global $db;
    
    $rows = $db->querySelect(TABLE_PROGRAM_LANGS, array('id', 'name'));
    $names = array();
    foreach($rows as $row) {
        $names[$row['id']] = $row['name'];
    }
    return $names;
}
 
/**
 * Describes a programming language information block. Each instance has some
 * basic information about the respecting programming language.
 * @author Andreas Launila
 * @package com.lokorin.lokorin.lib
 */
class ProgrammingLanguage extends TableEntry {
    /**
     * The name of the programming language.
     * @var string 
     */
    private $name;
    /**
     * A brief description about the programming language.
     * @var string 
     */
    private $description;
    
    /**
     * Constructor for ProgrammingLanguage.
     * @param integer $id The unique identifier for the programming language.
     */
    public function __construct($id) {
        $fields = array(
            'name', 
            'description'
        );
        parent::__construct(TABLE_PROGRAM_LANGS, $id, $fields);
    }
 
    /**
     * @see com.lokorin.lokorin.TableEntry.readRow($row)
     */
    protected function readRow($row) {
        $this->name = $row['name'];
        $this->description = $row['description'];
    }
    
    /**
     * Gets the name of the programming language.
     * @return string A language name.
     * @access public
     */
    function getName() {
        return $this->name;
    }
    
    /**
     * Gets the description of the programming language.
     * @return string A description.
     * @access public
     */
    function getDescription() {
        return $this->description;
    }
    
    /**
     * Gets a link to the language. More information about the language is
     * displayed when the link is clicked.
     * @return string XHTML compliant code representing a link.
     * @access public
     */
    function getLink() {
        return '<a href="'.PAGE_ROOT.'languages/'.strtolower($this->name).'">'.
                $this->name.'</a>';
    }
}
?>