User Guide

286 Chapter 14: Document
String manipulation functions
String manipulation functions help you get information about a string as well as convert a string
from Latin 1 encoding to platform-native encoding and back.
dreamweaver.doURLEncoding()
Availability
Dreamweaver 1.
Description
Takes a string and returns a URL-encoded string by replacing all the spaces and special characters
with specified entities.
Arguments
stringToConvert
• The stringToConvert argument is a string that contains the unencoded URL that the
function encodes.
Returns
A URL-encoded string.
Example
The following example shows the URL.value for "My URL-encoded string":
var URL = dw.doURLEncoding(theURL.value);
returns "My%20URL-encoded%20string"
dreamweaver.getTokens()
Availability
Dreamweaver 1.
Description
Accepts a string and splits it into tokens.
Arguments
searchString, separatorCharacters
• The searchString argument is the string to separate into tokens.
• The separatorCharacters argument is the character or characters that signifies the end of a
token. Separator characters in quoted strings are ignored. Any white-space characters that
occur in
separatorCharacters (such as tabs) are treated as separator characters, as if they
are explicitly specified. Two or more consecutive white space characters are treated as a
single separator.
Returns
An array of token strings.
000_DW_API_Print.book Page 286 Wednesday, August 20, 2003 9:14 AM