Different syntax coloring for '$_' variables possible
[phpeclipse.git] / net.sourceforge.phpeclipse / src / net / sourceforge / phpeclipse / phpeditor / php / PHPCodeScanner.java
1 /**********************************************************************
2  Copyright (c) 2000, 2002 IBM Corp. and others.
3  All rights reserved. This program and the accompanying materials
4  are made available under the terms of the Common Public License v1.0
5  which accompanies this distribution, and is available at
6  http://www.eclipse.org/legal/cpl-v10.html
7
8  Contributors:
9  IBM Corporation - Initial implementation
10  www.phpeclipse.de
11  **********************************************************************/
12 package net.sourceforge.phpeclipse.phpeditor.php;
13
14 import java.util.ArrayList;
15 import java.util.List;
16
17 import net.sourceforge.phpdt.internal.ui.text.AbstractJavaScanner;
18 import net.sourceforge.phpdt.ui.text.IColorManager;
19 import net.sourceforge.phpeclipse.IPreferenceConstants;
20 import net.sourceforge.phpeclipse.phpeditor.PHPSyntaxRdr;
21 import net.sourceforge.phpeclipse.phpeditor.util.PHPWhitespaceDetector;
22 import net.sourceforge.phpeclipse.phpeditor.util.PHPWordDetector;
23
24 import org.eclipse.jface.preference.IPreferenceStore;
25 import org.eclipse.jface.text.rules.ICharacterScanner;
26 import org.eclipse.jface.text.rules.IRule;
27 import org.eclipse.jface.text.rules.IToken;
28 import org.eclipse.jface.text.rules.IWordDetector;
29 import org.eclipse.jface.text.rules.MultiLineRule;
30 import org.eclipse.jface.text.rules.Token;
31 import org.eclipse.jface.text.rules.WhitespaceRule;
32 import org.eclipse.jface.text.rules.WordRule;
33
34 /**
35  * PHP Code Scanner
36  */
37 public class PHPCodeScanner extends AbstractJavaScanner {
38
39   /**
40    * Rule to detect java operators.
41    * 
42    * @since 3.0
43    */
44   protected class OperatorRule implements IRule {
45
46     /** Java operators */
47     private final char[] PHP_OPERATORS = {
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     /** Token to return for this rule */
74     private final IToken fToken;
75
76     /** Token to return for braces */
77     private final IToken fTokenBraces;
78
79     /**
80      * Creates a new operator rule.
81      * 
82      * @param token
83      *          Token to use for this rule
84      */
85     public OperatorRule(IToken token, IToken tokenBraces) {
86       fToken = token;
87       fTokenBraces = tokenBraces;
88
89     }
90
91     /**
92      * Is this character an operator character?
93      * 
94      * @param character
95      *          Character to determine whether it is an operator character
96      * @return <code>true</code> iff the character is an operator, <code>false</code> otherwise.
97      */
98     public boolean isOperator(char character) {
99       for (int index = 0; index < PHP_OPERATORS.length; index++) {
100         if (PHP_OPERATORS[index] == character)
101           return true;
102       }
103       return false;
104     }
105
106     /*
107      * @see org.eclipse.jface.text.rules.IRule#evaluate(org.eclipse.jface.text.rules.ICharacterScanner)
108      */
109     public IToken evaluate(ICharacterScanner scanner) {
110
111       int character = scanner.read();
112       if (character == '{' || character == '}') {
113         return fTokenBraces;
114       }
115       if (isOperator((char) character)) {
116         int lastCharacter = character;
117         character = scanner.read();
118         if (!isOperator((char) character)) {
119           scanner.unread();
120           return fToken;
121         }
122         if (checkPHPTag(scanner, lastCharacter, character)) {
123           return Token.UNDEFINED;
124         }
125         do {
126           lastCharacter = character;
127           character = scanner.read();
128           if (checkPHPTag(scanner, lastCharacter, character)) {
129             return fToken;
130           }
131         } while (isOperator((char) character));
132         scanner.unread();
133         return fToken;
134       } else {
135         scanner.unread();
136         return Token.UNDEFINED;
137       }
138     }
139
140     /**
141      * Check if lastCharacter/character are a PHP start or end token ( &lt;? ... ?&gt; )
142      * 
143      * @param scanner
144      * @param lastCharacter
145      * @param character
146      * @return
147      */
148     private boolean checkPHPTag(ICharacterScanner scanner, int lastCharacter, int character) {
149       if (lastCharacter == '<' && character == '?') {
150         scanner.unread();
151         scanner.unread();
152         return true;
153       } else if (lastCharacter == '?' && character == '>') {
154         scanner.unread();
155         scanner.unread();
156         return true;
157       }
158       return false;
159     }
160   }
161
162
163   protected class AccentStringRule implements IRule {
164
165     /** Token to return for this rule */
166     private final IToken fToken;
167
168     public AccentStringRule(IToken token) {
169       fToken = token;
170
171     }
172
173     /*
174      * @see org.eclipse.jface.text.rules.IRule#evaluate(org.eclipse.jface.text.rules.ICharacterScanner)
175      */
176     public IToken evaluate(ICharacterScanner scanner) {
177
178       int character = scanner.read();
179
180       if (character == '`') {
181
182         while (true) {
183           character = scanner.read();
184           if (character == '\\') {
185             character = scanner.read();
186           } else if (character == '`') {
187             return fToken;
188           }
189         }
190
191       } else {
192         scanner.unread();
193         return Token.UNDEFINED;
194       }
195     }
196
197   }
198
199   private class PHPWordRule extends WordRule {
200     private StringBuffer fBuffer = new StringBuffer();
201
202     public PHPWordRule(IWordDetector detector) {
203       super(detector, Token.UNDEFINED);
204     }
205
206     public PHPWordRule(IWordDetector detector, IToken defaultToken) {
207       super(detector, defaultToken);
208     }
209
210     public IToken evaluate(ICharacterScanner scanner) {
211       int c = scanner.read();
212       boolean isVariable = false;
213       boolean isUnderscore = false;
214       if (c == '<') {
215         c = scanner.read();
216         if (c != '?') {
217           scanner.unread();
218           scanner.unread();
219           return Token.UNDEFINED;
220         } else {
221           c = scanner.read();
222           if (c == '=') { // <?=
223             return getToken(IPreferenceConstants.PHP_TAG);
224           }
225           if (c != 'p' && c != 'P') {
226             scanner.unread();
227             return getToken(IPreferenceConstants.PHP_TAG);
228           } else {
229             c = scanner.read();
230             if (c != 'h' && c != 'H') {
231               scanner.unread();
232               scanner.unread();
233               return getToken(IPreferenceConstants.PHP_TAG);
234             } else {
235               c = scanner.read();
236               if (c != 'p' && c != 'P') {
237                 scanner.unread();
238                 scanner.unread();
239                 scanner.unread();
240                 return getToken(IPreferenceConstants.PHP_TAG);
241               } else {
242                 return getToken(IPreferenceConstants.PHP_TAG);
243               }
244             }
245           }
246         }
247       }
248       if (c == '?') {
249         c = scanner.read();
250         if (c == '>') {
251           return getToken(IPreferenceConstants.PHP_TAG);
252         }
253         scanner.unread();
254         scanner.unread();
255         return Token.UNDEFINED;
256       }
257       if (fDetector.isWordStart((char) c)) {
258         if (c == '$') {
259           isVariable = true;
260         }
261         if (fColumn == UNDEFINED || (fColumn == scanner.getColumn() - 1)) {
262
263           fBuffer.setLength(0);
264           fBuffer.append((char) c);
265           c = scanner.read();
266           if (c == '_') {
267             isUnderscore = true;
268           }
269           while (c != ICharacterScanner.EOF && fDetector.isWordPart((char) c)) {
270                 fBuffer.append((char) c);
271             c = scanner.read();
272           }
273           scanner.unread();
274
275           if (isVariable) {
276                 if (isUnderscore) {
277                         return getToken(IPreferenceConstants.PHP_VARIABLE_DOLLAR);
278                 }
279             return getToken(IPreferenceConstants.PHP_VARIABLE);
280           }
281           IToken token = (IToken) fWords.get(fBuffer.toString());
282           if (token != null)
283             return token;
284
285           if (fDefaultToken.isUndefined())
286             unreadBuffer(scanner);
287
288           return fDefaultToken;
289         }
290       }
291
292       scanner.unread();
293       return Token.UNDEFINED;
294     }
295   }
296
297   //private PHPColorProvider fColorProvider;
298
299   private static String[] fgTokenProperties = {
300       IPreferenceConstants.PHP_MULTILINE_COMMENT,
301       IPreferenceConstants.PHP_SINGLELINE_COMMENT,
302       IPreferenceConstants.PHP_TAG,
303       IPreferenceConstants.PHP_KEYWORD,
304       IPreferenceConstants.PHP_FUNCTIONNAME,
305       IPreferenceConstants.PHP_VARIABLE,
306       IPreferenceConstants.PHP_VARIABLE_DOLLAR,
307       IPreferenceConstants.PHP_STRING_DQ,
308       IPreferenceConstants.PHP_STRING_SQ,
309       IPreferenceConstants.PHP_TYPE,
310       IPreferenceConstants.PHP_CONSTANT,
311       IPreferenceConstants.PHP_DEFAULT,
312       IPreferenceConstants.PHP_OPERATOR,
313       IPreferenceConstants.PHP_BRACE_OPERATOR,
314       IPreferenceConstants.PHP_KEYWORD_RETURN };
315
316   /**
317    * Creates a PHP code scanner
318    */
319   // public PHPCodeScanner(JavaColorManager provider, IPreferenceStore store) {
320   public PHPCodeScanner(IColorManager manager, IPreferenceStore store) {
321     super(manager, store);
322     initialize();
323   }
324
325   /*
326    * @see AbstractJavaScanner#getTokenProperties()
327    */
328   protected String[] getTokenProperties() {
329     return fgTokenProperties;
330   }
331
332   /*
333    * @see AbstractJavaScanner#createRules()
334    */
335   protected List createRules() {
336     List rules = new ArrayList();
337     Token token = getToken(IPreferenceConstants.PHP_SINGLELINE_COMMENT);
338     // Add rule for single line comments.
339     //    rules.add(new EndOfLineRule("//", token)); //$NON-NLS-1$
340     //    rules.add(new EndOfLineRule("#", token)); //$NON-NLS-1$
341     // Add rule for strings and character constants.
342     //    token = getToken(IPreferenceConstants.PHP_STRING_SQ);
343     //    rules.add(new SingleQuoteStringRule(token));
344     //    token = getToken(IPreferenceConstants.PHP_STRING_DQ);
345     //    rules.add(new DoubleQuoteStringRule(token));
346     rules.add(new AccentStringRule(token));
347
348     token = getToken(IPreferenceConstants.PHP_MULTILINE_COMMENT);
349     rules.add(new MultiLineRule("/*", "*/", token)); //$NON-NLS-2$ //$NON-NLS-1$
350     // Add generic whitespace rule.
351     rules.add(new WhitespaceRule(new PHPWhitespaceDetector()));
352     // Add word rule for keywords, types, and constants.
353     token = getToken(IPreferenceConstants.PHP_DEFAULT);
354     PHPWordRule wordRule = new PHPWordRule(new PHPWordDetector(), token);
355
356     Token keyword = getToken(IPreferenceConstants.PHP_KEYWORD);
357     Token functionName = getToken(IPreferenceConstants.PHP_FUNCTIONNAME);
358     Token type = getToken(IPreferenceConstants.PHP_TYPE);
359     Token constant = getToken(IPreferenceConstants.PHP_CONSTANT);
360
361     ArrayList buffer = PHPSyntaxRdr.getSyntaxData();
362     //  String strbuffer = null; unused
363     PHPElement elbuffer = null;
364     String name;
365     for (int i = 0; i < buffer.size(); i++) {
366       //    while ((buffer != null)
367       //      && (!buffer.isEmpty()
368       //        && ((elbuffer = (PHPElement) buffer.remove(0)) != null))) {
369       elbuffer = (PHPElement) buffer.get(i);
370       if (elbuffer instanceof PHPKeyword) {
371         name = ((PHPKeyword) elbuffer).getName();
372         if (!name.equals("return")) {
373           wordRule.addWord(name, keyword);
374         }
375       } else if (elbuffer instanceof PHPFunction) {
376         wordRule.addWord(((PHPFunction) elbuffer).getName(), functionName);
377       } else if (elbuffer instanceof PHPType) {
378         wordRule.addWord(elbuffer.getName(), type);
379       } else if (elbuffer instanceof PHPConstant) {
380         wordRule.addWord(elbuffer.getName(), constant);
381       }
382     }
383
384     // Add word rule for keyword 'return'.
385     token = getToken(IPreferenceConstants.PHP_KEYWORD_RETURN);
386     wordRule.addWord("return", token);
387
388     //  Add rule for operators and brackets (at the end !)
389     rules.add(new OperatorRule(getToken(IPreferenceConstants.PHP_OPERATOR), getToken(IPreferenceConstants.PHP_BRACE_OPERATOR)));
390
391     rules.add(wordRule);
392
393     setDefaultReturnToken(getToken(IPreferenceConstants.PHP_DEFAULT));
394     return rules;
395   }
396 }