> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alumio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mappers

This page will explain what mappers are and how they translate values from one system to another.

The following mappers are available:

| Name                                                                                                  | Description                                                                                                                                                                                              |
| ----------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Apply operator to value](/references/mapper/operator)                                                | Maps a value based on the supplied operator.                                                                                                                                                             |
| [Apply operator with prepared values](/references/mapper/prepared-operator)                           | Applies the operator on every item of the left and right array values.                                                                                                                                   |
| [Array or object: Count items](/references/mapper/list-count)                                         | Returns the number of items in an array or the number of keys in an object.                                                                                                                              |
| [Array or object: Diff values](/references/mapper/list-diff)                                          | Returns the values present in the input but not in the supplied data.                                                                                                                                    |
| [Array or object: Flip keys and values](/references/mapper/list-flip)                                 | Swaps the keys and values of an array or object.                                                                                                                                                         |
| [Array or object: Get values](/references/mapper/list-values)                                         | Returns the values of an array or object as an indexed array.                                                                                                                                            |
| [Array or object: Inherit from data](/references/mapper/list-inherit-from)                            | Fills missing keys in the array or object from the supplied data.                                                                                                                                        |
| [Array or object: Join into string (implode)](/references/mapper/list-implode)                        | Joins array items or object values into a single string using a separator.                                                                                                                               |
| [Array or object: Keep matching values](/references/mapper/list-intersect)                            | Returns only the values that exist in both the input and the supplied data.                                                                                                                              |
| [Array or object: Merge](/references/mapper/list-extend-with)                                         | Merges the supplied data into the array or object. Existing keys are overwritten.                                                                                                                        |
| [Array or object: Reverse](/references/mapper/list-reverse)                                           | Reverses the order of items in an array or keys in an object.                                                                                                                                            |
| [Array or object: Split into chunks](/references/mapper/list-split)                                   | Splits an array or object into chunks of the specified size.                                                                                                                                             |
| [Array: Extract field](/references/mapper/list-column)                                                | Gets the values for a single key from each item in an array.                                                                                                                                             |
| [Array: Fill with value](/references/mapper/list-fill)                                                | Creates an array filled with a repeated value at the specified length.                                                                                                                                   |
| [Array: Join into string](/references/mapper/list-concat)                                             | Joins array items into a single string using a separator.                                                                                                                                                |
| [Cast: Boolean](/references/mapper/cast-bool)                                                         | Converts a value into a boolean (true/false).                                                                                                                                                            |
| [Cast: Float](/references/mapper/cast-float)                                                          | Converts a value into a float (1.00, 2.05, 10.50, etc).                                                                                                                                                  |
| [Cast: Integer](/references/mapper/cast-int)                                                          | Converts a value into an integer (1, 2, 3, 10, 25, etc).                                                                                                                                                 |
| [Cast: String](/references/mapper/cast-string)                                                        | Converts a value into a string ("abc", "example").                                                                                                                                                       |
| [Chain mappers](/references/mapper/chain)                                                             | Executes a list of mappers in sequence.                                                                                                                                                                  |
| [Filesystem: Resolve destination filename conflict](/references/mapper/filesystem-ensure-destination) | Ensures a destination path is available on the filesystem. If a file already exists at the path, applies a conflict resolution strategy (for example, appending a counter: foo.json becomes foo-2.json). |
| [Filter: Allow only digits](/references/mapper/string-filter-numbers)                                 | Takes the input and makes sure all non numeric characters are removed.                                                                                                                                   |
| [Filter: Allow only letters](/references/mapper/string-filter-letters)                                | Takes the input and makes sure all characters other than letters are removed. It means it will also remove spaces.                                                                                       |
| [Filter: Allow only letters and digits](/references/mapper/string-filter-alnum)                       | Allows only letters and digits; removes all other characters.                                                                                                                                            |
| [Format date value](/references/mapper/format-date)                                                   | Converts a date value to another format based on the given criteria.                                                                                                                                     |
| [Format number value](/references/mapper/format-number)                                               | Applies number formatting to the input. Several arguments can be used to get the desired result.                                                                                                         |
| [Format to Form URL encoded](/references/mapper/serialize-form-urlencoded)                            | Converts a data object or array into a Form URL encoded string.                                                                                                                                          |
| [Format to JSON](/references/mapper/serialize-json)                                                   | Converts a data object or array into a JSON formatted string.                                                                                                                                            |
| [Format to URL encoded](/references/mapper/serialize-url-encode)                                      | Converts a data object or array into a URL encoded string.                                                                                                                                               |
| [Format to XLSX](/references/mapper/serialize-xlsx)                                                   | Converts a data object or array into a binary XLSX file.                                                                                                                                                 |
| [Format to XML](/references/mapper/serialize-xml)                                                     | Converts a data object or array into an XML formatted string.                                                                                                                                            |
| [Format to YAML](/references/mapper/serialize-yaml)                                                   | Converts a data object or array into a YAML formatted string.                                                                                                                                            |
| [Format to cXML](/references/mapper/serialize-cxml)                                                   | Converts a data object or array into a cXML formatted string.                                                                                                                                            |
| [Format to selected format](/references/mapper/serialize)                                             | Converts a data object into the desired output format.                                                                                                                                                   |
| [Locale: Display region](/references/mapper/locale-display-region)                                    | Gets the region for the locale string in the supplied language.                                                                                                                                          |
| [Map value using comparator](/references/mapper/standard)                                             | Maps a value to the 'to' value based on the comparator.                                                                                                                                                  |
| [Map value using dictionary](/references/mapper/dictionary-map)                                       | Converts input from one value into another using a lookup dictionary. For example, the value “1” into “One”, “Yes” into “Si”, etc.                                                                       |
| [Map when a condition applies](/references/mapper/conditional)                                        | Applies mappers when the conditions apply.                                                                                                                                                               |
| [Math: absolute value](/references/mapper/math-abs)                                                   | Gets the absolute value for an integer or float.                                                                                                                                                         |
| [Math: ceil](/references/mapper/math-ceil)                                                            | Rounds to the next highest integer.                                                                                                                                                                      |
| [Math: floor](/references/mapper/math-floor)                                                          | Rounds to the next lowest integer.                                                                                                                                                                       |
| [Math: round](/references/mapper/math-round)                                                          | Rounds a number to the provided precision.                                                                                                                                                               |
| [Object: Diff keys](/references/mapper/list-diff-keys)                                                | Returns the keys present in the object but not in the supplied data.                                                                                                                                     |
| [Object: Get keys](/references/mapper/list-keys)                                                      | Returns the keys of an object as an array.                                                                                                                                                               |
| [Object: Keep matching keys](/references/mapper/list-intersect-keys)                                  | Returns only the keys that exist in both the object and the supplied data.                                                                                                                               |
| [Object: Sort keys](/references/mapper/object-sort-keys)                                              | Sorts the keys of an object based on the provided sort method and direction.                                                                                                                             |
| [Parse from Form URL encoded](/references/mapper/deserialize-form-urlencoded)                         | Converts a Form URL encoded string into a data object.                                                                                                                                                   |
| [Parse from JSON](/references/mapper/deserialize-json)                                                | Parses a JSON string into a data object.                                                                                                                                                                 |
| [Parse from URL encoded](/references/mapper/deserialize-url-encode)                                   | Decodes a URL encoded string into plain text.                                                                                                                                                            |
| [Parse from XML](/references/mapper/deserialize-xml)                                                  | Parses an XML string into a data object.                                                                                                                                                                 |
| [Parse from YAML](/references/mapper/deserialize-yaml)                                                | Converts a YAML string into a data object.                                                                                                                                                               |
| [Parse from cXML](/references/mapper/deserialize-cxml)                                                | Parses a cXML string into a data object.                                                                                                                                                                 |
| [Parse from selected format](/references/mapper/deserialize)                                          | Converts a string in XML, JSON, CSV, or other formats into a data object.                                                                                                                                |
| [String: Append](/references/mapper/string-append)                                                    | Appends a string to the data.                                                                                                                                                                            |
| [String: Base64 decode](/references/mapper/string-base64-decode)                                      | Decodes a base64 encoded string back to its original value.                                                                                                                                              |
| [String: Base64 encode](/references/mapper/string-base64-encode)                                      | Takes the input string and converts it to a base64 encoded value. It can be used for example to create an identifier based on certain values in the data.                                                |
| [String: Capitalize first word](/references/mapper/string-upper-first)                                | Takes the given input string and converts the first letter to a capital. This only works when en phrase starts with a lowercase letter.                                                                  |
| [String: Convert character set of string](/references/mapper/string-iconv)                            | Converts a string from one encoding to another.                                                                                                                                                          |
| [String: Convert encoding](/references/mapper/string-convert-encoding)                                | Converts a string to the specified encoding. The from encoding must be known.                                                                                                                            |
| [String: Convert to lowercase](/references/mapper/string-lower)                                       | Takes the given input and casts all letters to a lower case. The given input must be a valid string.                                                                                                     |
| [String: Convert to uppercase](/references/mapper/string-upper)                                       | Converts all letters in the input to uppercase.                                                                                                                                                          |
| [String: Cut](/references/mapper/string-cut)                                                          | Cuts a string at the provided length value starting the count at the start value.                                                                                                                        |
| [String: Decode HTML entities](/references/mapper/string-html-entity-decode)                          | HTML decodes a string to human-readable text.                                                                                                                                                            |
| [String: Encode HTML entities](/references/mapper/string-html-entity-encode)                          | Encodes all HTML entities in a string.                                                                                                                                                                   |
| [String: Explode to an array](/references/mapper/string-explode)                                      | Takes the given input string and converts it to an array/list based on a specified split character.                                                                                                      |
| [String: Explode to an array using a regular expression](/references/mapper/string-preg-split)        | Explodes a string based on a supplied regex.                                                                                                                                                             |
| [String: Extract directory from path](/references/mapper/string-file-dirname)                         | Extracts the directory portion from a file path. For example, '/uploads/image.jpg' returns '/uploads'.                                                                                                   |
| [String: Extract filename from path](/references/mapper/string-file-basename)                         | Extracts the filename from a file path. For example, '/uploads/image.jpg' returns 'image.jpg'.                                                                                                           |
| [String: Generate dispersed file path](/references/mapper/string-dispersion)                          | Generates a nested directory path from a string, distributing files across subdirectories to avoid large flat directories.                                                                               |
| [String: Hash](/references/mapper/string-hash)                                                        | Hashes a string with the provided algorithm, the output can be a string or binary.                                                                                                                       |
| [String: Parse file path into parts](/references/mapper/string-file-pathinfo)                         | Parses a file path into its components (directory, filename, and extension).                                                                                                                             |
| [String: Prepend](/references/mapper/string-prepend)                                                  | Prepends a value onto a string.                                                                                                                                                                          |
| [String: Replace](/references/mapper/string-replace)                                                  | Replaces within a string based on a string comparison.                                                                                                                                                   |
| [String: Replace using regular expression](/references/mapper/string-regex-replace)                   | Replaces part of a string based on the supplied regex.                                                                                                                                                   |
| [String: Slugify](/references/mapper/string-slugify)                                                  | Removes all non-alphanumeric characters and replaces them with hyphens (-).                                                                                                                              |
| [String: Strip HTML tags](/references/mapper/string-strip-html)                                       | Removes the HTML tags from a string. A set of tags can be supplied to be excluded.                                                                                                                       |
| [String: Transliterate](/references/mapper/string-transliterate-id)                                   | Transliterates a string based on the supplied transliterator. Can be used to change UTF-16 code units into single characters.                                                                            |
| [String: Trim characters](/references/mapper/string-trim)                                             | Trims characters from the left or right side of a string.                                                                                                                                                |
