charCodeAt (string)

charCodeAt Task Purpose

The charCodeAt task is used to obtain a Unicode decimal value (UTF-16) for a character at a specific position in a string. UTF-16 is a 16-bit integer between 0 and 65535.

Potential Use Cases

This task is a character-processing method that returns an encoded value at a specific location, rather than the character itself. You could use charCodeAt to perform string handling with characters you cannot type directly using a keyboard.

This task is also useful for working with strings used in objects such as a Text Field, Context Menu or File Reference object. Let's say you have an input form with a text field that requires an email address. Some browsers only look for the @ symbol and other browsers look for a pattern consisting of @ followed by at least one letter and a dot. You could use charCodeAt to build a text validation function in the form control to parse the email address character by character to validate if the entry is formatted correctly.

Properties

Input and output properties are shown below.

Examples

Example 1

In the IAP examples shown below:

• The reference variable for the incoming str is statically set to Hello World!.

• The index number is 4.

  

• Once the workflow is executed, the code value is displayed under the Outgoing tab in Task History, which is accessed from Jobs in Operations Manager.

• The character code 111 is equal to the lowercase letter "o".

  

Example 2

In the IAP examples shown below:

• The reference variable for the incoming str is statically set to Hello Krunal Legere.

• The index number is 5.

  

• The character code that returns is 32, which is equal to a space in the string.