1 <?php

     2 

     3 /**

     4  * Zend Framework

     5  *

     6  * LICENSE

     7  *

     8  * This source file is subject to the new BSD license that is bundled

     9  * with this package in the file LICENSE.txt.

    10  * It is also available through the world-wide-web at this URL:

    11  * http://framework.zend.com/license/new-bsd

    12  * If you did not receive a copy of the license and are unable to

    13  * obtain it through the world-wide-web, please send an email

    14  * to license@zend.com so we can send you a copy immediately.

    15  *

    16  * @category   Zend

    17  * @package    Zend_Gdata

    18  * @subpackage App

    19  * @copyright  Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)

    20  * @license    http://framework.zend.com/license/new-bsd     New BSD License

    21  * @version    $Id: Util.php 20096 2010-01-06 02:05:09Z bkarwin $

    22  */

    23 

    24 /**

    25  * Utility class for static functions needed by Zend_Gdata_App

    26  *

    27  * @category   Zend

    28  * @package    Zend_Gdata

    29  * @subpackage App

    30  * @copyright  Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)

    31  * @license    http://framework.zend.com/license/new-bsd     New BSD License

    32  */

    33 class Zend_Gdata_App_Util

    34 {

    35 

    36     /**

    37      *  Convert timestamp into RFC 3339 date string.

    38      *  2005-04-19T15:30:00

    39      *

    40      * @param int $timestamp

    41      * @throws Zend_Gdata_App_InvalidArgumentException

    42      */

    43     public static function formatTimestamp($timestamp)

    44     {

    45         $rfc3339 = '/^(\d{4})\-?(\d{2})\-?(\d{2})((T|t)(\d{2})\:?(\d{2})' .

    46                    '\:?(\d{2})(\.\d{1,})?((Z|z)|([\+\-])(\d{2})\:?(\d{2})))?$/';

    47 

    48         if (ctype_digit($timestamp)) {

    49             return gmdate('Y-m-d\TH:i:sP', $timestamp);

    50         } elseif (preg_match($rfc3339, $timestamp) > 0) {

    51             // timestamp is already properly formatted

    52             return $timestamp;

    53         } else {

    54             $ts = strtotime($timestamp);

    55             if ($ts === false) {

    56                 require_once 'Zend/Gdata/App/InvalidArgumentException.php';

    57                 throw new Zend_Gdata_App_InvalidArgumentException("Invalid timestamp: $timestamp.");

    58             }

    59             return date('Y-m-d\TH:i:s', $ts);

    60         }

    61     }

    62 

    63     /** Find the greatest key that is less than or equal to a given upper

    64       * bound, and return the value associated with that key.

    65       *

    66       * @param integer|null $maximumKey The upper bound for keys. If null, the

    67       *        maxiumum valued key will be found.

    68       * @param array $collection An two-dimensional array of key/value pairs

    69       *        to search through.

    70       * @returns mixed The value corresponding to the located key.

    71       * @throws Zend_Gdata_App_Exception Thrown if $collection is empty.

    72       */

    73     public static function findGreatestBoundedValue($maximumKey, $collection)

    74     {

    75         $found = false;

    76         $foundKey = $maximumKey;

    77 

    78         // Sanity check: Make sure that the collection isn't empty

    79         if (sizeof($collection) == 0) {

    80             require_once 'Zend/Gdata/App/Exception.php';

    81             throw new Zend_Gdata_App_Exception("Empty namespace collection encountered.");

    82         }

    83 

    84         if ($maximumKey === null) {

    85             // If the key is null, then we return the maximum available

    86             $keys = array_keys($collection);

    87             sort($keys);

    88             $found = true;

    89             $foundKey = end($keys);

    90         } else {

    91             // Otherwise, we optimistically guess that the current version

    92             // will have a matching namespce. If that fails, we decrement the

    93             // version until we find a match.

    94             while (!$found && $foundKey >= 0) {

    95                 if (array_key_exists($foundKey, $collection))

    96                     $found = true;

    97                 else

    98                     $foundKey--;

    99             }

   100         }

   101 

   102         // Guard: A namespace wasn't found. Either none were registered, or

   103         // the current protcol version is lower than the maximum namespace.

   104         if (!$found) {

   105             require_once 'Zend/Gdata/App/Exception.php';

   106             throw new Zend_Gdata_App_Exception("Namespace compatible with current protocol not found.");

   107         }

   108 

   109         return $foundKey;

   110     }

   111 

   112 }