Hide Table of Contents
esri
esri/arcgis
esri/dijit
esri/dijit/analysis
esri/dijit/geoenrichment
esri/dijit/geoenrichment/ReportPlayer
esri/geometry
esri/layers
esri/renderers
esri/symbols
esri/tasks
esri/tasks/datareviewer
esri/tasks/geoenrichment
esri/tasks/locationproviders
Object: esri/lang
[ AMD Module Require | Legacy Module Require ]
Description
(Added at v3.8)
Utility methods for working with strings, arrays and objects.When coding legacy (non-AMD) style, there is no need to require the module. All methods and properties are available in the namespace. For example,
esri.filter().Samples
Search for samples that use this class.Methods
| Name | Return type | Summary |
|---|---|---|
| filter(object, callback, thisObject?) | Object | Creates a new object with all properties that pass the test implemented by the filter provided in the function. |
| isDefined(value) | Boolean | Returns true when the value is neither null or undefined. |
| stripTags(value) | Object | String | Strips HTML tags from a String or Object. |
| substitute(data, template?, options?) | String | A wrapper around dojo.string.substitute that can also handle wildcard substitution. |
| valueOf(array, value) | Object | Iterates through the argument array and searches for the identifier to which the argument value matches. |
Method Details
Creates a new object with all properties that pass the test implemented by the filter provided in the function.
Return type:
ObjectParameters:
< |
Required | Object to filter. |
< |
Required | Function or string implementing the filtering. |
< |
Optional | Optional object used to scope the call to the callback. |
Sample:
function showResults(results) {
var filterFunction = function(value) {
if ((value !== ' ') & (Number(value) !== 0)) {
return true;
};
};
var filteredResults = esri.filter(results.features[0].attributes, filterFunction);
var s = "";
for (att in filteredResults) {
s = s + "<b>" + att + ":</b> " + filteredResults[att] + "<br />";
};
dojo.byId("info").innerHTML = s;
};
Returns true when the value is neither null or undefined. Otherwise false.
Return type:
BooleanParameters:
< |
Required | The value to test. |
Strips HTML tags from a String or Object. This method modifies the Object used as input and does not return a new value. If a String is used as input, a new String is returned. (Added at v3.13)
A wrapper around dojo.string.substitute that can also handle wildcard substitution. A wildcard uses the format of ${*}. If no template is provided, it is assumed to be a wildcard. This method is useful if you are not using Graphic or an InfoTemplate, but you want to embed result values in HTML, for example.
Return type:
StringParameters:
< |
Required | The data object used in the substitution. |
< |
Optional | The template used for the substitution. Can be any valid HTML. If no template is included, the wildcard template is used. |
< |
Optional | Object containing a format object used in the substitution. |
Object Specifications:
<
options>< |
Optional | This object contains key:value pairs where the key is either a
value object supports formatType property. This can be one of the following types:
|
< |
Optional | This object contains key:value pairs where the key is either a
value object supports formatType property. This can be one of the following types:
|
Iterates through the argument array and searches for the identifier to which the argument value matches. Returns null if no matching identifier is found.
Return type:
ObjectParameters:
< |
Required | The argument array for testing. |
< |
Required | The value used in the search. If the value is a String, the value is case sensitive. |
Sample:
Example 1:
esri.valueOf([firststring: "Oregon", secondstring: "Washington"], "Washington");
Returns: secondstring
Example 2:
esri.valueOf([firststring: "Oregon", secondstring: "Washington"], "Virginia");
Returns: null