Iterator, ArrayAccess, Countable: Object as an array

0. परिचय।

मानक php पैकेज में 2 दिलचस्प इंटरफेस हैं, जो आपको भाषा में वस्तुओं के व्यवहार को महत्वपूर्ण रूप से बदलने की अनुमति देते हैं।
ये Iterator और ArrayAccess हैं। पहले आपको इस तरह के निर्माण के माध्यम से ऑब्जेक्ट को पुनरावृत्त करने की अनुमति देता है, प्रत्येक के लिए, फ़ॉरच,। दूसरा, बदले में, आपको परिचित $ सरणी [] = 'newItem' का उपयोग करके एक सरणी के रूप में ऑब्जेक्ट को एक्सेस करने की अनुमति देता है। तदनुसार, सरणी के पूर्ण अनुकरण के लिए, वस्तु को दोनों इंटरफेस को लागू करना चाहिए।

1. Iterator।

Iterator (उर्फ कर्सर) एक व्यवहार डिजाइन पैटर्न है। Php में, इसे Iterator इंटरफ़ेस द्वारा दर्शाया गया है और इसके लिए निम्नलिखित विधियों के कार्यान्वयन की आवश्यकता है:

• सार्वजनिक फ़ंक्शन रिवाइंड () - पॉइंटर को शून्य स्थिति पर रीसेट करें;
• सार्वजनिक समारोह वर्तमान () - वर्तमान मूल्य की वापसी;
• सार्वजनिक फ़ंक्शन कुंजी () - वर्तमान तत्व की कुंजी लौटाएं;
• सार्वजनिक फ़ंक्शन अगला () - अगले तत्व पर शिफ्ट;
• सार्वजनिक फ़ंक्शन मान्य () - Iterator के बाद कॉल किया जाना चाहिए :: वर्तमान स्थिति मान्य है या नहीं, इसकी जांच करने के लिए rewind () या Iterator :: next ()।

तदनुसार, ये विधियां सामान्य रीसेट (), वर्तमान (), कुंजी (), अगला () के एनालॉग हैं।

उदाहरण 1:

class Iteratable implements Iterator { protected $_position = 0; protected $_container = array ( 'item1', 'item2', 'item3' ); public function __construct() { $this->_position = 0; } public function rewind() { $this->_position = 0; } public function current() { return $this->_container[$this->_position]; } public function key() { return $this->_position; } public function next() { ++$this->_position; } public function valid() { return isset($this->_container[$this->_position]); } } $iteratable = new Iteratable; foreach ($iteratable as $item) { var_dump($iteratable->key(), $item); } 

लेकिन वर्तमान वर्ग अभी भी छद्म-सरणी नहीं है। अब यह अभी भी उन मूल्यों को बदलने का अवसर नहीं देता है जो इसमें शामिल हैं।

2. ArrayAccess।

इस इंटरफ़ेस का कार्यान्वयन आपको किसी भी उपलब्ध फ़ंक्शन के एक सरणी के रूप में ऑब्जेक्ट तक पहुंचने की अनुमति देगा। इंटरफ़ेस में 4 सार विधियाँ हैं:

• अमूर्त सार्वजनिक बूलियन ऑफसेट (मिश्रित $ ऑफसेट) - क्या दिए गए कुंजी के लिए मूल्य मौजूद है;
• अमूर्त सार्वजनिक मिश्रित ऑफसेटगेट (मिश्रित $ ऑफसेट) - सूचकांक द्वारा मूल्य प्राप्त करें;
• अमूर्त सार्वजनिक शून्य ऑफ़सेट (मिश्रित $ ऑफसेट, मिश्रित $ मूल्य) - सूचकांक के साथ मान सेट करें;
• अमूर्त सार्वजनिक शून्य ऑफसेट (मिश्रित $ ऑफसेट) - मान हटाएं।

उदाहरण 2:

 class ArrayAccessable implements ArrayAccess { protected $_container = array(); public function __construct($array = null) { if (!is_null($array)) { $this->_container = $array; } } public function offsetExists($offset) { return isset($this->_container[$offset]); } public function offsetGet($offset) { return $this->offsetExists($offset) ? $this->_container[$offset] : null; } public function offsetSet($offset, $value) { if (is_null($offset)) { $this->_container[] = $value; } else { $this->_container[$offset] = $value; } } public function offsetUnset($offset) { unset($this->_container[$offset]); } } $array = new ArrayAccessable(array('a', 'b', 'c', 'd', 'e' => 'assoc')); var_dump($array); unset($array['e']); var_dump('unset: ', $array); $array['meta'] = 'additional element'; var_dump('set: ', $array); var_dump(count($array)); 

अब ArrayAccessable class का एक उदाहरण एक अरै की तरह काम करता है। लेकिन गिनती () अभी भी 1 लौटती है (ऐसा क्यों? देखें http://www.php.net/manual/en/function.count.php )।

3. गणना योग्य।

इंटरफ़ेस में सिर्फ एक विधि शामिल है, जिसे गिनती () के साथ उपयोग के लिए बनाया गया था।

• सार सार्वजनिक int count (शून्य) - वस्तु के तत्वों की संख्या।

उदाहरण 3

 class CountableObject implements Countable { protected $_container = array('a', 'b', 'c', 'd'); public function count() { return count($this->_container); } } $countable = new CountableObject; var_dump(count($countable)); 

लेकिन हमारी वस्तु अभी भी एक वस्तु के रूप में क्रमबद्ध हो रही है, एक सरणी नहीं ...

4. सीरियल करने योग्य।

एक इंटरफ़ेस जो आपको ऑब्जेक्ट को क्रमबद्ध करने के तरीके को फिर से परिभाषित करने की अनुमति देता है।
2 नामों के साथ विधियाँ शामिल हैं:

• सार सार्वजनिक स्ट्रिंग क्रमबद्ध (शून्य);
• एब्सट्रैक्ट पब्लिक मिक्स अनसेरीलाइज़ (स्ट्रिंग $ सीरियलाइज़्ड)

उदाहरण 4

 class SerializableObject implements Serializable { protected $_container = array('a', 'b', 'c', 'd'); public function serialize() { return serialize($this->_container); } public function unserialize($data) { $this->_container = unserialize($data); } } $serializable = new SerializableObject; var_dump($serializable); // SerializableObject file_put_contents('serialized.txt', serialize($serializable)); $unserialized = unserialize(file_get_contents('serialized.txt')); var_dump($unserialized); // SerializableObject 

अब वस्तु केवल आंकड़ों को क्रमबद्ध करती है, स्वयं को नहीं।

5. परिणाम।

ऊपर वर्णित वर्गों को एक में जोड़कर, हमें एक वस्तु मिलती है जो एक सरणी की तरह व्यवहार करती है।
एकमात्र दोष यह है कि array_pop () जैसे फ़ंक्शन इसके साथ काम नहीं करेंगे।
समाधान के रूप में, आप php 5.3 __invoke () से नई मैजिक पद्धति का उपयोग कर सकते हैं, जो आपको एक फ़ंक्शन के रूप में ऑब्जेक्ट को कॉल करने की अनुमति देगा और इस प्रकार इन कार्यों को काम करेगा।

 public function __invoke(array $data = null) { if (is_null($data)) { return $this->_container; } else { $this->_container = $data; } } $array = new SemiArray(array('a', 'b', 'c', 'd', 'e' => 'assoc')); $tmp = $array(); array_pop($tmp); $array($tmp); var_dump('array_pop', $array); 

विकल्प बैकअप है, अन्य विकल्प आपकी टिप्पणियों में प्रतीक्षा कर रहे हैं।
परिणामी वर्ग की पूरी सूची:

 class SemiArray implements ArrayAccess, Countable, Iterator, Serializable { protected $_container = array(); protected $_position = 0; public function __construct(array $array = null) { if (!is_null($array)) { $this->_container = $array; } } public function offsetExists($offset) { return isset($this->_container[$offset]); } public function offsetGet($offset) { return $this->offsetExists($offset) ? $this->_container[$offset] : null; } public function offsetSet($offset, $value) { if (is_null($offset)) { $this->_container[] = $value; } else { $this->_container[$offset] = $value; } } public function offsetUnset($offset) { unset($this->_container[$offset]); } public function rewind() { $this->_position = 0; } public function current() { return $this->_container[$this->_position]; } public function key() { return $this->_position; } public function next() { ++$this->_position; } public function valid() { return isset($this->_container[$this->_position]); } public function count() { return count($this->_container); } public function serialize() { return serialize($this->_container); } public function unserialize($data) { $this->_container = unserialize($data); } public function __invoke(array $data = null) { if (is_null($data)) { return $this->_container; } else { $this->_container = $data; } } } 

परीक्षण:

 $array = new SemiArray(array('a', 'b', 'c', 'd', 'e' => 'assoc')); var_dump($array); $array->next(); var_dump('advanced key: ', $array->key()); unset($array['e']); var_dump('unset: ', $array); $array['meta'] = 'additional element'; var_dump('set: ', $array); echo 'count: '; var_dump(count($array)); file_put_contents('serialized.txt', serialize($array)); echo 'unserialized:'; var_dump($array); // SemiArray $array = unserialize(file_get_contents('serialized.txt')); $tmp = $array(); array_pop($tmp); $array($tmp); var_dump('array_pop', $array); 

6. स्कोप।

6.1। उदाहरण के लिए, डेटाबेस से चयन के परिणामों में।

चेतावनी! छद्म कोड।

 class Rowset extends SemiArray { protected $_total; public function __construct() { $this->_total = $db->query('SELECT FOUND_ROWS() as total')->total; } public function getTotal() { return $this->_total; } } $rowset = new Rowset(); while ($obj = mysql_fetch_object($res)) { $rowset[] = $obj; } foreach ($rowset as $row) { // ... } $rowset->getTotal(); // total row count 

7. आउटरो।

लेख शैक्षिक उद्देश्यों के लिए लिखा गया था, और कार्यान्वयन पहले से ही बिल्ड-इन क्लास ArrayObject ( http://www.php.net/manual/en/class.arrayobject.php ) में php में उपलब्ध है।