<?php

/**
 * @author Thorsten Rotering <support@rotering-net.de>
 * @version 1.1 (2016-05-06)
 *
 * Hiermit wird unentgeltlich, jeder Person, die eine Kopie dieses Skripts erhält, die Erlaubnis erteilt,
 * diese uneingeschränkt zu benutzen, inklusive und ohne Ausnahme, dem Recht, sie zu verwenden, zu kopieren,
 * zu ändern, zu fusionieren, zu verlegen, zu verbreiten, zu unterlizenzieren und/oder zu verkaufen, und
 * Personen, die dieses Skript erhalten, diese Rechte zu geben, unter den folgenden Bedingungen:
 *
 * Der obige Urheberrechtsvermerk und dieser Erlaubnisvermerk sind in allen Kopien oder Teilkopien des
 * Skripts beizulegen.
 *
 * DAS SKRIPT WIRD OHNE JEDE AUSDRÜCKLICHE ODER IMPLIZIERTE GARANTIE BEREITGESTELLT, EINSCHLIESSLICH DER
 * GARANTIE ZUR BENUTZUNG FÜR DEN VORGESEHENEN ODER EINEM BESTIMMTEN ZWECK SOWIE JEGLICHER RECHTSVERLETZUNG,
 * JEDOCH NICHT DARAUF BESCHRÄNKT. IN KEINEM FALL SIND DIE AUTOREN ODER COPYRIGHTINHABER FÜR JEGLICHEN SCHADEN
 * ODER SONSTIGE ANSPRÜCHE HAFTBAR ZU MACHEN, OB INFOLGE DER ERFÜLLUNG EINES VERTRAGES, EINES DELIKTES ODER
 * ANDERS IM ZUSAMMENHANG MIT DEM SKRIPT ODER SONSTIGER VERWENDUNG DES SKRIPTS ENTSTANDEN.
 */

/**
 * Umschließt die übergebene Zeichenfolge in Backticks.
 * @param string $pString Die Zeichenfolge, die in Backticks gesetzt werden soll.
 * @return string Die in Backticks gesetzte Zeichenfolge.
 */
function mysql_backticks($pString)
{
    return '`' . $pString . '`';
}

/**
 * Erzeugt aus zwei Spalten einer Datenbank-Tabelle eine HTML-Optionsliste.
 * @param string $pDatabaseTable Der Name der Datenbank-Tabelle.
 * @param string $pValueColumn Der Name des Tabellenspalte mit den Indexwerten.
 * @param string $pLabelColumn Der Name der Tabellenspalte mit den Beschriftungen.
 * @param int $pSelectedValue (optional) Der Indexwert der aktuellen Auswahl .
 * @return string Die in HTML ausgezeichnete Optionsliste.
 */
function create_optionlist($pDatabaseTable, $pValueColumn, $pLabelColumn, $pSelectedValue = 0)
{
    $lDatabaseTable = mysql_backticks(mysql_real_escape_string($pDatabaseTable));
    $lValueColumn = mysql_backticks(mysql_real_escape_string($pValueColumn));
    $lLabelColumn = mysql_backticks(mysql_real_escape_string($pLabelColumn));
    $lSelectedValue = (int)$pSelectedValue;
    $lOptionList = '';

    $lQuery = 'SELECT ' . $lValueColumn . ', ' . $lLabelColumn . ' FROM ' . $lDatabaseTable . ' ORDER BY ' .
     $lLabelColumn;    
    $lResult = mysql_query($lQuery);
    
    if (!$lResult) {
        exit('Datenbankfehler in der Funktion create_optionlist():' . mysql_error());
    }

    while ($lRow = mysql_fetch_row($lResult)) {
        $lOptionList .= '<option value="' . $lRow[0] . '"' .
         ($lRow[0] == $lSelectedValue ? ' selected="selected"' : '') . '>' . htmlspecialchars($lRow[1]) . '</option>';
    }

    return $lOptionList;
}