TokensToUpper (StringTokenizer property): Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 1: Line 1:
<span style="font-size:120%; color:black"><b>Convert returned tokens to all-uppercase?</b></span>
{{Template:StringTokenizer:TokensToUpper subtitle}}
[[Category:StringTokenizer methods|TokensToUpper property]]
<!--DPL?? Category:StringTokenizer methods|TokensToUpper property: Convert returned tokens to all-uppercase?-->
<!--DPL?? Category:System methods|TokensToUpper (StringTokenizer property): Convert returned tokens to all-uppercase?-->
<p>
TokensToUpper is a member of the [[StringTokenizer class]].
</p>


This readWrite property returns or sets the Boolean value that indicates
This readWrite property returns or sets the Boolean value that indicates
Line 11: Line 5:
The default value for a new tokenizer is <tt>False</tt>.
The default value for a new tokenizer is <tt>False</tt>.


===Syntax===
==Syntax==
  %bool = %tok:TokensToUpper
{{Template:StringTokenizer:TokensToUpper syntax}}
 
  %tok:TokensToUpper = %bool
===Syntax terms===
===Syntax terms===
<dl>
<dl>
Line 25: Line 17:


</dl>
</dl>
===Usage Notes===
==Usage notes==
<ul>
<ul>
<li>TokensToUpper has no effect on non-alphabetic characters.
<li>TokensToUpper has no effect on non-alphabetic characters.
Line 31: Line 23:
returned tokens are to be converted to lowercase characters.
returned tokens are to be converted to lowercase characters.
</ul>
</ul>
===Examples===
==Examples==


In the following example,
In the following example,
Line 61: Line 53:
     %tok:nextToken is Z}
     %tok:nextToken is Z}
</pre>
</pre>
==See also==
{{Template:StringTokenizer:TokensToUpper footer}}

Revision as of 19:54, 6 February 2011

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

%bool
An enumeration object of type Boolean to contain the returned value of TokensToUpper. For more information about Boolean enumerations, see Using Boolean enumerations.
%tok
A StringTokenizer object variable.

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.

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 instantiated object, the resulting tokens are:

    %tok:nextToken is BAD,F
    %tok:nextToken is ?3MO
    %tok:nextToken is ,7,{X
    %tok:nextToken is Z}

See also