Skip to main content
aboutsummaryrefslogtreecommitdiffstats
blob: 53d8368e6a59f9c6cb19e3f2f3cea0e6dec83ea2 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
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
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
/*******************************************************************************
 * Copyright (c) 2009, 2015 IBM Corporation and others.
 *
 * This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License 2.0
 * which accompanies this distribution, and is available at
 * https://www.eclipse.org/legal/epl-2.0/
 *
 * SPDX-License-Identifier: EPL-2.0
 *
 * Contributors:
 *     Mike Kucera (IBM) - Initial API and implementation
 *     Richard Eames
 *******************************************************************************/
package org.eclipse.cdt.internal.core.parser.scanner;

import org.eclipse.cdt.core.parser.IToken;

/**
 * Utility class that provides some simple operations for string literals.
 */
@SuppressWarnings("nls")
public enum StringType {
	// Listed in order of "wideness"
	NARROW("", IToken.tSTRING),
	WIDE("L",  IToken.tLSTRING),
	UTF16("u", IToken.tUTF16STRING),
	UTF32("U", IToken.tUTF32STRING);


	private char[] prefix;
	private int tokenVal;

	private StringType(String prefix, int tokenVal) {
		this.prefix = prefix.toCharArray();
		this.tokenVal = tokenVal;
	}

	public char[] getPrefix() {
		return prefix;
	}

	public int getTokenValue() {
		return tokenVal;
	}

	/**
	 * Returns the StringType value that represents the 'wider' of the two given StringTypes.
	 * @throws NullPointerException if an argument is null
	 */
	public static StringType max(StringType st1, StringType st2) {
		return values()[Math.max(st1.ordinal(), st2.ordinal())];
	}

	/**
	 * Returns the StringType value for the given string literal type.
	 *
	 * @see IToken#tSTRING
	 * @see IToken#tLSTRING
	 * @see IToken#tUTF16STRING
	 * @see IToken#tUTF32STRING
	 *
	 * @throws IllegalArgumentException if the tokenVal does not represent a string literal
	 */
	public static StringType fromToken(int tokenVal) {
		switch (tokenVal) {
		case IToken.tSTRING:      return NARROW;
    	case IToken.tLSTRING:     return WIDE;
        case IToken.tUTF16STRING: return UTF16;
        case IToken.tUTF32STRING: return UTF32;
        default:
        	throw new IllegalArgumentException(tokenVal + " is not a string token");
		}
	}

	/**
	 * Returns the StringType for a given string literal token, including a user-defined string literal
	 * @see StringType#fromToken(int)
	 * @since 5.10
	 */
	public static StringType fromToken(IToken token) {
		switch (token.getType()) {
		case IToken.tSTRING:      return NARROW;
		case IToken.tLSTRING:     return WIDE;
		case IToken.tUTF16STRING: return UTF16;
		case IToken.tUTF32STRING: return UTF32;
		case IToken.tUSER_DEFINED_STRING_LITERAL: {
			char[] image = token.getCharImage();
			switch (image[0]) {
			case 'R':
			case '"': return NARROW;
			case 'L': return WIDE;
			case 'u':
				if (image.length > 3 && image[1] == '8') {
					return NARROW;
				}
				return UTF16;
			case 'U': return UTF32;
			}
		}
			//$FALL-THROUGH$
		default:
			throw new IllegalArgumentException(token.getType() + " is not a string token");
		}
	}
}

Back to the top