---

layout: section title: “KvSwap” permalink: /documentation/transforms/python/elementwise/kvswap/ section_menu: section-menu/documentation.html

Kvswap

{% include button-pydoc.md path=“apache_beam.transforms.util” class=“KvSwap” %}

Takes a collection of key-value pairs and returns a collection of key-value pairs which has each key and value swapped.

Examples

In the following example, we create a pipeline with a PCollection of key-value pairs. Then, we apply KvSwap to swap the keys and values.

{% github_sample /apache/beam/blob/master/sdks/python/apache_beam/examples/snippets/transforms/elementwise/kvswap.py tag:kvswap %}```

{:.notebook-skip}
Output `PCollection` after `KvSwap`:

{:.notebook-skip}

{% github_sample /apache/beam/blob/master/sdks/python/apache_beam/examples/snippets/transforms/elementwise/kvswap_test.py tag:plants %}```

{% include buttons-code-snippet.md py=“sdks/python/apache_beam/examples/snippets/transforms/elementwise/kvswap.py” notebook=“examples/notebooks/documentation/transforms/python/elementwise/kvswap” %}

Related transforms

• [Keys]({{ site.baseurl }}/documentation/transforms/python/elementwise/keys) for extracting the key of each component.
• [Values]({{ site.baseurl }}/documentation/transforms/python/elementwise/values) for extracting the value of each element.

{% include button-pydoc.md path=“apache_beam.transforms.util” class=“KvSwap” %}