Map Manipulations
This guide will help you with the following:
- Create Map
- Put Key
- Put All Key
- Remove Key
- Clear Map
Maps provide a more general way of storing elements. Map collection type in Deluge allows you to store a pairs of elements, such as "keys" and "values", in which each key maps to one value. Conceptually, Lists are Maps with numeric keys.
The following sections explain the different types of map variables available in Deluge.
Create Map
The CreateMap deluge syntax creates a new empty map expression. If the target map variable is already defined as map variable, then all its content will be erased. The map expression related tasks (put, putAll, remove, clear) and opertions can be done only if the map variable is defined.
map() - map constructor to create and initalize map variable.
{} - Holds map values. Handy syntax for creating map with some initial values.
{} - Holds map values. Handy syntax for creating map with some initial values.
Example: hdrs = { "Email" : "support@mydomain.com", "Passwd" : "mypassword", "accountType" : "HOSTED_OR_GOOGLE", "service" : "cl" };
Example
In the following sample code, a map named map1 is defined in the on add -> on load block and initialized with the map() constructor.
- map1 = map(); // map constructor to initalize the map variable named map1.
- map1.put("creator","http://crm.zoho.com");
- map1.put("writer","http://writer.zoho.com");
- map1.put("sheet","http://sheet.zoho.com");
- // Following is map constructor to declare a variable with default values
- hdrs = { "Email" : "support@mydomain.com", "Passwd" : "mypassword", "accountType" : "HOSTED_OR_GOOGLE", "service" : "cl" };
Put Key
The Put Key Deluge task inserts a key-value pair into the map variable. If the specifed key is already present in the map-variable, then the key's associated value will be replaced with a new value.
Syntax
- <map1>.put(<key>,<value>);
In the above syntax,
- <map1> refers to the name of the map variable.
- <key> refers to the key to be inserted to the target map variable.
- <value> refers to the value to be associated with the given key in the target map variable.
Example
- map1 = map();
- map1.put("John", "India");
- map1.put("David", "USA");
Put All Key
The Put All Key Deluge task inserts all key-value pairs into the specified map variable. If the key(s) are already present in the map-variable, then the key's associated value will be replaced with new value.
Syntax
- <target-map variable>.put(<source-map-variable>);
In the above syntax,
- <target-map variable> is a map variable in which the action take place
- <source-map-variable> is a map variable from where all the key-value mappings will be added to the above target map variable
Example
In the following sample code, the key-value pairs in the "Games" map is added to the "Sports" map.
- {
- Games=map();
- Games.put("Cricket","Sachin");
- Games.put("Tennis","SteffiGraf");
- Games.put(("Badminton"),"SainaNehwal");
- Sports=map();
- Sports.put(Games);
- }
Remove Key
The Remove key Deluge task removes the specified key and its associated value from the target map variable.
Syntax
- <map-variable>.remove(<key-name>);
In the above syntax,
- <map-variable> refers to the map name from where the specified key and its associated value will be removed.
- <key-name> refers to the key to be removed from the map variable
Example
In the following example, the key-value pair ("John", "India") available in map1 will be removed.
- map1 = map();
- map1.put("John", "India");
- map1.put("David", "USA");
- if(map1.containKey("John"))
- {
- alert("John is lived in " + map1.get("John"));
- }
- else
- {
- alert("No Information available");
- }
- map1.remove("John");
Clear Map
The Clear Map Deluge task removes all the key-value mappings from the map.
Syntax
- <map>.clear();
In the above syntax,
- <map> refers to the name of the map to be cleared.
Example
In the following example, all key-value mappings in "map1" will be removed.
- map1 = map();
- map1.put("John", "India");
- map1.put("David", "USA");
- alert(map1.size() + "entries available"); //before clear task, the map variable's size is 2
- map1.clear();
- alert(map1.size() + "entries available"); //after clear task, the map variable's size is 0
Zoho CRM Training Programs
Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.
Zoho DataPrep Personalized Demo
If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.
- Zoho Workerly Home
- Forums
- Connect With Us:
- Zoho Recruit Home
- Forums
- Connect With Us:
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho Marketing Plus?
Everything you need to run your marketing
New to Zoho Marketing Plus?
Everything you need to run your marketing
You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.
New to Zoho Survey?
Zoho Sheet Resources
Zoho Forms Resources
New to Zoho Sign?
Zoho Sign Resources
Sign, Paperless!
New to Zoho TeamInbox?
Zoho TeamInbox Resources
New to Zoho ZeptoMail?
Zoho DataPrep Resources
Design. Discuss. Deliver.
New to Zoho Workerly?
New to Zoho Recruit?
New to Zoho CRM?
New to Zoho Projects?
New to Zoho Sprints?
New to Zoho Assist?
New to Bigin?
Related Articles
Map Manipulations - Create Map
This guide will help you with the following: Overview Syntax Examples Overview The create map deluge task is used to declare a map variable. Syntax To declare a map variable <variable> = Map(); To create a map variable with key value pairs <variable> ...Map Manipulations - Clear map
This guide will help you with the following: Overview Syntax Example Overview The clear map deluge task empties a specified map variable by permanently removing all its key-value pairs. Syntax <map_variable>.clear(); This task can be used in the ...Map Manipulations - Put Operation
This guide will help you with the following: Overview Syntax Examples Overview The put deluge task inserts a specified key-value pair in a pre-defined map variable. Syntax <map_variable>.put(<key>, <value>); This task can be used in the following ...Map Manipulations - Remove Key
This guide will help you with the following: 1. Overview 2. Syntax 3. Example Overview The remove key deluge task removes a specified key and its value from a specified map variable. Syntax <map_variable>.remove(<key>); This task can be used in the ...Map Manipulations - Put all keys
This guide will help you with the following: Overview Syntax Example Overview The put all keys deluge task inserts all key-value pairs present in one map variable(map_variable2) to another map variable(map_variable1). Syntax ...
New to Zoho LandingPage?
Zoho LandingPage Resources