Blame view

pma/libraries/List.class.php 2.72 KB
a1684257   Administrator   first commit
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
  <?php
  /* vim: set expandtab sw=4 ts=4 sts=4: */
  /**
   * hold the PMA_List base class
   *
   * @package PhpMyAdmin
   */
  
  /**
   * @todo add caching
   * @since phpMyAdmin 2.9.10
   * @abstract
   * @package PhpMyAdmin
   */
  abstract class PMA_List extends ArrayObject
  {
      /**
       * @var mixed   empty item
       */
      protected $item_empty = '';
  
      public function __construct($array = array(), $flags = 0, $iterator_class = "ArrayIterator")
      {
          parent::__construct($array, $flags, $iterator_class);
      }
  
      /**
       * returns item only if there is only one in the list
       *
       * @return  single item
       */
      public function getSingleItem()
      {
          if (count($this) === 1) {
              return reset($this);
          }
  
          return $this->getEmpty();
      }
  
      /**
       * defines what is an empty item (0, '', false or null)
       *
       * @return  mixed   an empty item
       */
      public function getEmpty()
      {
          return $this->item_empty;
      }
  
      /**
       * checks if the given db names exists in the current list, if there is
       * missing at least one item it returns false otherwise true
       *
       * @param string  $db_name,..     one or more mysql result resources
       * @return  boolean true if all items exists, otheriwse false
       */
      public function exists()
      {
          $this_elements = $this->getArrayCopy();
          foreach (func_get_args() as $result) {
              if (! in_array($result, $this_elements)) {
                  return false;
              }
          }
  
          return true;
      }
  
      /**
       * returns HTML <option>-tags to be used inside <select></select>
       *
       * @param mixed   $selected   the selected db or true for selecting current db
       * @param boolean $include_information_schema
       * @return  string  HTML option tags
       */
      public function getHtmlOptions($selected = '', $include_information_schema = true)
      {
          if (true === $selected) {
              $selected = $this->getDefault();
          }
  
          $options = '';
          foreach ($this as $each_item) {
              if (false === $include_information_schema
                      && PMA_is_system_schema($each_item)) {
                  continue;
              }
              $options .= '<option value="' . htmlspecialchars($each_item) . '"';
              if ($selected === $each_item) {
                  $options .= ' selected="selected"';
              }
              $options .= '>' . htmlspecialchars($each_item) . '</option>' . "\n";
          }
  
          return $options;
      }
  
      /**
       * returns default item
       *
       * @return  string  default item
       */
      public function getDefault()
      {
          return $this->getEmpty();
      }
  
      /**
       * builds up the list
       *
       */
      abstract public function build();
  }
  ?>