<?php
/* -*- tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*
# ***** BEGIN LICENSE BLOCK *****
# This file is part of Plume Framework, a simple PHP Application Framework.
# Copyright (C) 2001-2007 Loic d'Anterroches and contributors.
#
# Plume Framework is free software; you can redistribute it and/or modify
# it under the terms of the GNU Lesser General Public License as published by
# the Free Software Foundation; either version 2.1 of the License, or
# (at your option) any later version.
#
# Plume Framework is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
#
# ***** END LICENSE BLOCK ***** */

/**
 * Signal system.
 */
class Pluf_Signal
{

    /**
     * Send a signal.
     *
     * @param string Signal to be sent.
     * @param string Sender.
     * @param array Parameters
     * @return void
     */
    public static function send($signal, $sender, &$params=array())
    {
        if (!empty($GLOBALS['_PX_signal'][$signal])) {
            foreach ($GLOBALS['_PX_signal'][$signal] as $key=>$val) {
                if ($val[2] === null or $sender == $val[2]) {
                    call_user_func_array(array($val[0], $val[1]), 
                                         array($signal, &$params));
                }
            }
        }
    }


    /**
     * Connect to a signal.
     *
     * @param string Name of the signal.
     * @param array array('class', 'method') handling the signal.
     * @param string Optional sender filtering.
     */
    public static function connect($signal, $who, $sender=null)
    {
        if (!isset($GLOBALS['_PX_signal'])) {
            $GLOBALS['_PX_signal'] = array();
        }
        if (!isset($GLOBALS['_PX_signal'][$signal])) {
            $GLOBALS['_PX_signal'][$signal] = array();
        }
        $GLOBALS['_PX_signal'][$signal][] = array($who[0], $who[1], $sender);
    }
}