---
name: "stag-join"
section: "1p"
platform: "linux"
package: "libdata-stag-perl"
version: "0.14-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/stag-join"
---

# stag-join(1p)

joins two stag files together based around common key

## NAME

stag-join - joins two stag files together based around common key

## SYNOPSIS

```
  stag-join  -w xml country/city_id=capital/capital_id countries.xml capitals.xml
  stag-join  -w itext gene/tax_id=species/tax_id genedb.itext speciesdb.itext
```

## DESCRIPTION

Performs a relational-style INNER JOIN between two stag trees; this effectively merges two files together, based on some kind of ID in the file

## ARGUMENTS

- \-p\|parser FORMAT

  FORMAT is one of xml, sxpr or itext, or the name of a perl module

  xml assumed as default

- \-w\|writer FORMAT

  FORMAT is one of xml, sxpr or itext, or the name of a perl module

## LIMITATIONS

currently not event based, so may not be memory efficicent. could be easily rewritten to be event based

## SEE ALSO

Data::Stag

This script is a wrapper for the method

```
  Data::Stag->ijoin()
```