cvs: php-src /ext/spl spl.php
| From: | Marcus Boerger | Date: | Wed, 09 Mar 2005 01:21:06 +0000 |
| Subject: | cvs: php-src /ext/spl spl.php | ||
| Groups: | php.cvs | ||
| Request: | Send a blank email to php-cvs+get-30791@lists.php.net to get a copy of this message | ||
helly Tue Mar 8 20:21:06 2005 EDT
Modified files:
/php-src/ext/spl spl.php
Log:
Add description for interface Serializeable
http://cvs.php.net/diff.php/php-src/ext/spl/spl.php?r1=1.44&r2=1.45&ty=u
Index: php-src/ext/spl/spl.php
diff -u php-src/ext/spl/spl.php:1.44 php-src/ext/spl/spl.php:1.45
--- php-src/ext/spl/spl.php:1.44 Tue Mar 1 18:44:05 2005
+++ php-src/ext/spl/spl.php Tue Mar 8 20:21:04 2005
@@ -435,6 +435,33 @@
function count();
}
+/** @ingroup ZendEngine
+ * @brief Interface for customized serializing
+ * @since 5.1
+ *
+ * Classes that implement this interface no longer support __sleep() and
+ * __wakeup(). The method serialized is called whenever an instance needs to
+ * be serialized. This does not invoke __destruct() or has any other side
+ * effect unless programmed inside the method. When the data is unserialized
+ * the class is known and the appropriate unserialize() method is called as a
+ * constructor instead of calling __construct(). If you need to execute the
+ * standard constructor you may do so in the method.
+ */
+interface Serializeable
+{
+ /**
+ * @return string representation of the instance
+ */
+ function serialize();
+
+ /**
+ * @note This is a constructor
+ *
+ * @param $serialized data read from stream to construct the instance
+ */
+ function unserialize($serialized);
+}
+
/** @ingroup SPL
* @brief An Array wrapper
* @since PHP 5.0