TokensToUpper (StringTokenizer property): Difference between revisions
mNo edit summary |
m (→Examples) |
||
| (3 intermediate revisions by one other user not shown) | |||
| Line 17: | Line 17: | ||
<tr><th>newBoolean</th> | <tr><th>newBoolean</th> | ||
<td> The <var>Boolean</var> value to assign to <var class="term">stringTokenizer</var>'s <var>TokensToUpper</var> property.</td></tr> | <td> The <var>Boolean</var> value to assign to <var class="term">stringTokenizer</var>'s <var>TokensToUpper</var> property. Setting it to <code>true</code> causes tokens to be uppercased when returned, and the <var>TokensToLower</var> property to be ignored.</td></tr> | ||
</table> | </table> | ||
| Line 24: | Line 24: | ||
<li><var>TokensToUpper</var> has no effect on non-alphabetic characters. | <li><var>TokensToUpper</var> has no effect on non-alphabetic characters. | ||
<li>The <var>[[TokensToLower (StringTokenizer property)|TokensToLower]]</var> property specifies or reports whether | <li>The <var>[[TokensToLower (StringTokenizer property)|TokensToLower]]</var> property specifies or reports whether | ||
returned tokens are to be converted to lowercase characters. | returned tokens are to be converted to lowercase characters; however, if <var>TokensToUpper</var> is <code>true</code>, then <var>TokensToLower</var> is ignored. | ||
</ul> | </ul> | ||
| Line 34: | Line 34: | ||
%tok:string = 'Bad,F ?3mO ,7,{x Z}' | %tok:string = 'Bad,F ?3mO ,7,{x Z}' | ||
repeat while not %tok:atEnd | repeat while not %tok:atEnd | ||
printText {~} is {%tok:nextToken} | [[Targeted Text statements#AuditText, PrintText, and TraceText|printText]] {~} is {%tok:nextToken} | ||
end repeat | end repeat | ||
</p> | </p> | ||
| Line 45: | Line 45: | ||
</p> | </p> | ||
If <code>%tok: | If <code>%tok:tokensToUpper = true</code> is specified for the object, | ||
the resulting tokens are: | the resulting tokens are: | ||
<p class="code">%tok:nextToken is BAD,F | <p class="code">%tok:nextToken is BAD,F | ||
Latest revision as of 20:59, 15 November 2012
Convert returned tokens to all-uppercase (StringTokenizer class)
This readWrite property returns or sets the Boolean value that indicates
whether to convert returned, non-quoted, tokens to all-uppercase characters.
The default value for a new tokenizer is False.
Syntax
%currentBoolean = stringTokenizer:TokensToUpper stringTokenizer:TokensToUpper = newBoolean
Syntax terms
| %currentBoolean | An Boolean enumeration object to contain the returned value of TokensToUpper. |
|---|---|
| stringTokenizer | A StringTokenizer object. |
| newBoolean | The Boolean value to assign to stringTokenizer's TokensToUpper property. Setting it to true causes tokens to be uppercased when returned, and the TokensToLower property to be ignored. |
Usage notes
- TokensToUpper has no effect on non-alphabetic characters.
- The TokensToLower property specifies or reports whether
returned tokens are to be converted to lowercase characters; however, if TokensToUpper is
true, then TokensToLower is ignored.
Examples
In the following example, the input string's tokens are returned in sequence under the default (False) setting of TokensToUpper:
%tok is object stringtokenizer %tok = new %tok:string = 'Bad,F ?3mO ,7,{x Z}' repeat while not %tok:atEnd printText {~} is {%tok:nextToken} end repeat
The resulting tokens are:
%tok:nextToken is Bad,F %tok:nextToken is ?3mO %tok:nextToken is ,7,{x %tok:nextToken is Z}
If %tok:tokensToUpper = true is specified for the object,
the resulting tokens are:
%tok:nextToken is BAD,F %tok:nextToken is ?3MO %tok:nextToken is ,7,{X %tok:nextToken is Z}