Differences

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

--- rfc:token_as_object [2020/02/13 09:37] – created nikic
+++ rfc:token_as_object [2020/02/13 12:45] – Add missing "static" in example code guilliamxavier
@@ Line 46: / Line 46: @@
 </code>
-==== Additional methods ====
+===== Open Questions =====
-There are a few useful helper methods that could be added to the ''PhpToken'' class. Whether these should be added as part of this proposal is an **open question**.
+==== Construction method ====
+The RFC currently proposes a new ''TOKEN_AS_OBJECT'' flag to the existing ''token_get_all()'' function. Nicolas Grekas suggested to use a new function or method instead, to make this functionality more easily polyfillable.
+To make the functionality self-contained, a new static method on ''PhpToken'' could be added:
+<PHP>
+class PhpToken {
+    /** @return PhpToken[] */
+    public static function getAll(string $code, int $flags = 0);
+}
+</PHP>
+==== Additional methods ====
-Three suggestions are given as PHP code below. The ''is()'' method is a useful helper, variations of which will be found in many libraries processing token streams. ''isIgnorable()'' helps the particularly common case of skipping whitespace-like tokens. ''getTokenName()'' avoids going through ''token_name()'' for debug output.
+There are a few useful helper methods that could be added to the ''PhpToken'' class. Three suggestions are given as PHP code below. The ''is()'' method is a useful helper, variations of which will be found in many libraries processing token streams. ''isIgnorable()'' helps the particularly common case of skipping whitespace-like tokens. ''getTokenName()'' avoids going through ''token_name()'' for debug output.
 <PHP>
@@ Line 88: / Line 101: @@
             T_DOC_COMMENT,
             T_OPEN_TAG,
-            T_BAD_CHARACTER,
         ]);
     }

Differences

Page Tools