// ========================================================================
// Cookie handling
// Adapted by Lexitech Ltd (http://www.lexitech.co.uk)
// from Danny Goodman's JavaScript & DHTML Cookbook
//   section 1.9 p. 16
//     author    : Danny Goodman
//     title     : JavaScript & DHTML Cookbook
//     publisher : O'Reilly
//     ISBN      : 0-596-00467-2
// ========================================================================
// $Id: cookies.js 497 2005-03-04 17:52:33Z tprice $
// ========================================================================

// utility function to retrieve an expiration date in proper
// format; pass three integer parameters for the number of days, hours,
// and minutes from now you want the cookie to expire (or negative
// values for a past date); all three parameters are required,
// so use zeros where appropriate
function getExpDate(days, hours, minutes) {
    var expDate = new Date();
    if (typeof days == "number" && typeof hours == "number" &&
        typeof minutes == "number") {
        expDate.setDate(expDate.getDate() + parseInt(days));
        expDate.setHours(expDate.getHours() + parseInt(hours));
        expDate.setMinutes(expDate.getMinutes() + parseInt(minutes));
        return expDate.toGMTString();
    }
}

// utility function called by getCookie()
function getCookieVal(offset) {
    var endstr = document.cookie.indexOf(";", offset);
    if (endstr == -1) {
        endstr = document.cookie.length;
    }
    return unescape(document.cookie.substring(offset, endstr));
}

// primary function to retrieve cookie by name
function getCookie(name) {
    var arg = name + "=";
    var alen = arg.length;
    var clen = document.cookie.length;
    var i = 0;
    while (i < clen) {
        var j = i + alen;
        if (document.cookie.substring(i, j) == arg) {
            return getCookieVal(j);
        }
        i = document.cookie.indexOf(" ", i) + 1;
        if (i == 0) break;
    }
    return "";
}

// retrieve the value part of a cookie's name=value pair
// e.g. suppose you have:
//   someCookie = 'name=Gromit;status=Higher dog;value=Platinum';
// then calling cookiePairVal(someCookie, 'status') would return
// 'Higher dog'
function cookiePairVal(cookieVal, name) {
    pairs = cookieVal.split(";");
    for (i = 0; i < pairs.length; i++) {
        split = pairs[i].split("=");
        if (split[0] == name) {
            return split[1];
        }
    }
    return "";
}

// retrieve all of a cookie's name=value pairs in an associative array
function cookiePairsAsArray(cookieVal) {
    pairs = cookieVal.split(";");
    parsed = new Array();
    for (i = 0; i < pairs.length; i++) {
        split = pairs[i].split("=");
        parsed[split[0]] = split[1];
    }
    return parsed;
}

// store cookie value with optional details as needed
function setCookie(name, value, expires, path, domain, secure) {
    document.cookie = name + "=" + escape(value) +
        ((expires) ? "; expires=" + expires : "") +
        ((path) ? "; path=" + path : "") +
        ((domain) ? "; domain=" + domain : "") +
        ((secure) ? "; secure=" + secure : "");
}

// remove the cookie by setting ancient expiration date
function deleteCookie(name, path, domain) {
    if (getCookie(name)) {
        document.cookie = name + "=" +
        ((path) ? "; path=" + path : "") +
        ((domain) ? "; domain=" + domain : "") +
        "; expires=Thu, 01-Jan-70 00:00:01 GMT";
    }
}