Unordered Mapping Language-Independent Type for YAML™ Version 1.1

Working Draft 2005-01-18

Oren Ben-Kiki

<oren@ben-kiki.org>

Clark Evans

<cce+yaml@clarkevans.com>

Brian Ingerson

<ingy@ttul.org>

This document may be freely copied provided it is not modified.

Status

This specification is a draft reflecting consensus reached by members of the yaml-core mailing list. Any questions regarding this draft should be raised on this list.

1. Mapping

URI:: tag:yaml.org,2002:map
Shorthand:: !!map
Kind:: Mapping.
Definition:: Associative container, where each key is unique in the association and mapped to exactly one value. YAML places no restrictions on the type of keys; in particular, they are not restricted to being scalars. Example bindings include Perl’s hash, Python’s dictionary, and Java’s Hashtable.
Resolution and Validation:: This tag accepts all mapping values. It is is typically used as the fall-back tag for mapping nodes.

Example 1. !!map Examples

# Unordered set of key: value pairs.
Block style: !!map
  Clark : Evans
  Brian : Ingerson
  Oren  : Ben-Kiki
Flow style: !!map { Clark: Evans, Brian: Ingerson, Oren: Ben-Kiki }