rfc:typehint

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Last revisionBoth sides next revision
rfc:typehint [2008/04/08 03:41] – New informations feliperfc:typehint [2008/04/17 16:59] – typo felipe
Line 3: Line 3:
   * Date: 2008-04-07   * Date: 2008-04-07
   * Author: Felipe Pena <felipensp@gmail.com>   * Author: Felipe Pena <felipensp@gmail.com>
-  * Status: Under Discussion+  * Status: [[http://news.php.net/php.internals/37049|Under Discussion]]
  
-===== BC Break ===== 
  
-== New tokens (new keywords) == +====== Details of implementation ====== 
-  - T_INTEGER (Keywords: int, integer) +**Parameter type hint:** 
-  - T_BOOLEAN (Keywords: bool, boolean) +  - The behavior when the default parameter value is ''NULL'' was kept. 
-  - T_DOUBLE (Keywords: real, float, double) +**Both:** 
-  - T_OBJECT (Keyword: object) +  - Binary and unicode string are specified by ''string''.
-  - T_RESOURCE (Keyword: resource) +
-  - T_STR (Keyword: string)+
  
 ===== Return value type hint ===== ===== Return value type hint =====
 +
 +==== BC Break ====
 +No BC break using the "(type)" syntax. (Inspirated by Objective-C)
 +
 +
 +==== Examples ====
  
 === Using inside namespaces === === Using inside namespaces ===
Line 46: Line 49:
 testing(new foo); testing(new foo);
 testing(new stdClass); // Catchable fatal error: The returned value must implement interface Itest testing(new stdClass); // Catchable fatal error: The returned value must implement interface Itest
 +</code>
 +
 +=== Interfaces ===
 +
 +<code php>
 +interface ITest {
 + public function (int) foo();
 +}
 +
 +class foo implements ITest {
 + public function (int) foo() {
 + return 'a';
 + }
 +}
 +
 +$test = new foo;
 +$test->foo(); // Catchable fatal error: The returned value must be of the type integer
 +</code>
 +
 +<code php>
 +interface ITest {
 + public function (int) foo();
 +}
 +
 +class foo implements ITest {
 + public function foo() {
 + return 1;
 + }
 +}
 +
 +$test = new foo;
 +$test->foo(); // Fatal error: Declaration of foo::foo() must be compatible with that of ITest::foo()
 +</code>
 +
 +=== Trying use with magic methods ===
 +<code php>
 +class test {
 + // Fatal error: Return type hint can't be used with magic methods
 + public function (int) __toString() {
 + }
 +}
 </code> </code>
  
Line 54: Line 98:
 } }
  
-test('1337'); +test('1337'); // Catchable fatal error: The returned value must be of the type integer
-test(-1); +
-test(1); +
-test(1.); // Catchable fatal error: The returned value needs be integer+
 </code> </code>
  
-===== Parameter type hint - Examples =====+ 
 +===== Parameter type hint ===== 
 + 
 +==== BC Break ==== 
 + 
 +== New tokens (new keywords) == 
 +  - T_INTEGER (Keywords: int, integer) 
 +  - T_BOOLEAN (Keywords: bool, boolean) 
 +  - T_DOUBLE (Keywords: real, float, double) 
 +  - T_OBJECT (Keyword: object) 
 +  - T_RESOURCE (Keyword: resource) 
 +  - T_STR (Keyword: string) 
 + 
 +==== Other changes ==== 
 +  - Removed ZEND_ARG_ARRAY_INFO() 
 +  - Added ZEND_ARG_PHP_TYPE_INFO() 
 +<code diff u> 
 +-#define ZEND_ARG_ARRAY_INFO(pass_by_ref, name, allow_null) { {#name}, sizeof(#name)-1, {NULL}, 0, 1, allow_null, pass_by_ref, 0, 0 }, 
 ++#define ZEND_ARG_PHP_TYPE_INFO(pass_by_ref, name, php_type, allow_null) { {#name}, sizeof(#name)-1, {NULL}, 0, php_type, allow_null, pass_by_ref, 0, 0 }, 
 +</code> 
 +  - **Reflection**: ReflectionParameter class: 
 +    - Added: 
 +      - isInt() 
 +      - isDouble() 
 +      - isBool() 
 +      - isString() 
 +      - isObject() 
 +      - isResource() 
 + 
 + 
 + 
 +==== Examples ==== 
 + 
 +=== With default parameter value === 
 +<code php> 
 +function test(integer $value = '1') { 
 +} 
 +// Fatal error: Default value for parameters with integer type hint can only be the exact type or NULL 
 +</code>
  
 === integer / int === === integer / int ===
Line 68: Line 147:
  
 test(1); test(1);
-test("1337"); 
 test(-1); test(-1);
-test("1."); // Catchable fatal error: Argument 1 passed to test() must be an integer, string given +test("1.");  
- +// Catchable fatal error: Argument 1 passed to test() must be of the type integer, string given ...
-function test(integer $value = '1') { +
-} +
-// Fatal error: Default value for parameters with integer type hint can only be the exact type or NULL+
 </code> </code>
  
Line 84: Line 159:
 test(1.1); test(1.1);
 test(.1); test(.1);
-test("1."); +test("1."); // Catchable fatal error: Argument 1 passed to test() must be of the type double, string given
-test("1337"); // Catchable fatal error: Argument 1 passed to test() must be an double, string given +
- +
-function test(double $value = '1') { +
-} +
-// Fatal error: Default value for parameters with double type hint can only be the exact type or NULL+
 </code> </code>
  
Line 98: Line 168:
  
 test(false); test(false);
-test(0); +test(0); // Catchable fatal error: Argument 1 passed to test() must be of the type boolean, null given
-test(1); +
-test('0'); +
-test('1'); +
-test(''); +
-test(null); // Catchable fatal error: Argument 1 passed to test() must be an boolean, null given+
 </code> </code>
  
Line 112: Line 177:
  
 test(fopen(__FILE__, 'r')); test(fopen(__FILE__, 'r'));
-test(NULL); // Catchable fatal error: Argument 1 passed to test() must be an resource, null given+test(NULL); // Catchable fatal error: Argument 1 passed to test() must be of the type resource, null given
 </code> </code>
  
Line 121: Line 186:
  
 test(new stdclass); test(new stdclass);
-test(NULL); // Catchable fatal error: Argument 1 passed to test() must be an object, null given+test(NULL); // Catchable fatal error: Argument 1 passed to test() must be of the type object, null given 
 +</code>
  
-function test(object $value = 1) { 
-} 
-// Fatal error: Default value for parameters with object type hint can only be the exact type or NULL 
-</code> 
  
  
-===== Patches =====+===== Patches & tests =====
  
   - Return value type hint: http://felipe.ath.cx/diff/return_type_hint.diff   - Return value type hint: http://felipe.ath.cx/diff/return_type_hint.diff
   - Parameter type hint: http://felipe.ath.cx/diff/param_type_hint.diff   - Parameter type hint: http://felipe.ath.cx/diff/param_type_hint.diff
 +  - Tests: http://felipe.ath.cx/diff/tests/
  
rfc/typehint.txt · Last modified: 2017/09/22 13:28 by 127.0.0.1

Page Tools