Text Functions
Glossary Item Box
| Microsoft Robotics Developer Studio | Send feedback on this topic |
Text Functions
.png "Text Functions")
Text Functions - Icon
The Text Functions service provides a set of functions that allow text strings to be manipulated.
This service supports the following requests.
| Request | Description |
|---|---|
| IsNullorEmpty | Indicates whether the specified string is a null reference. Returns true if the text string is null or empty, else returns false. |
| Contains | Returns a value indicating whether the specified string occurs within this string. Returns true if the searched for text is included in the string text, else false. |
| EndsWith | Determines whether the end of a string matches a specified string. Returns true if the string ends with the specified query text string, using the IgnoreCase comparison option. |
| IndexOf | Reports the index of the first occurrence of a string, or one or more characters, within another string. Returns the position of the first occurrence of the Query text in the String text. The search starts at the StartIndex character position and looks forwards. |
| Insert | Inserts a specified text string at a specified index position of another string. The text is inserted at the StartIndex. |
| Join | Concatenates the Separator text between each element of a specified string array. Results in a single concatenated string. (Opposite of Split). |
| LastIndexOf | Returns the character position of the last occurrence of the specified Query text within another string. The search starts at the StartIndex character position and looks backwards. |
| Pad | Aligns the String text, using the PaddingChar text, using PaddingLeft for the amount on left side and PaddingRight for the right side. (This function is not implemented for use in VPL). |
| Remove | Deletes a specified number of characters from the text string, beginning at the StartIndex position. |
| Replace | Replaces all occurrences of specified text in the text string, with the NewValue text. |
| Split | Returns a Strings text array from the elements of the String text, using the Separator text to delimit the elements. (Opposite of Join). |
| StartsWith | Returns true if the beginning of text matches the specified Query text, else returns false. |
| Substring | Returns the text substring from String text. The substring starts the StartIndex character position and uses Length as the length. |
| ToLower | Returns a copy of the String text converted to lowercase. |
| ToUpper | Returns a copy of the String text converted to uppercase. |
| Trim | Returns a text string after removing all leading (using PreserveLeftSpace) and trailing (using PreserveRightSpace) white-space characters from the String text. |
NOTE: Complex string manipulations are not a good use for VPL. If you have a requirement to do a lot of string processing, consider writing a service in C# that does what you want. You can use the code for the Text Functions as a starting point.
© 2012 Microsoft Corporation. All Rights Reserved.