---
name: "XML::Stream::Namespace"
section: "3pm"
platform: "linux"
package: "perl-xml-stream"
version: "1.24-13"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/XML::Stream::Namespace"
---

# XML::Stream::Namespace(3pm)

Object to make defining Namespaces easier in XML::Stream.

## NAME

XML::Stream::Namespace - Object to make defining Namespaces easier in \
                          XML::Stream.

## SYNOPSIS

XML::Stream::Namespace is a helper package to XML::Stream.  It provides a clean way of defining Namespaces for XML::Stream to use when connecting.

## DESCRIPTION

```
  This module allows you to set and read elements from an XML::Stream
  Namespace.
```

## METHODS

```
  SetNamespace("mynamespace");
  SetXMLNS("http://www.mynamespace.com/xmlns");
  SetAttributes(attrib1=>"value1",
                attrib2=>"value2");
  GetNamespace() returns "mynamespace"
  GetXMLNS() returns "http://www.mynamespace.com/xmlns"
  GetAttributes() returns a hash ( attrib1=>"value1",attrib2=>"value2")
  GetStream() returns the following string:
    "xmlns:mynamespace='http://www.nynamespace.com/xmlns'
     mynamespace:attrib1='value1'
     mynamespace:attrib2='value2'"
```

## EXAMPLES

```
  $myNamespace = XML::Stream::Namespace->new("mynamspace");
  $myNamespace->SetXMLNS("http://www.mynamespace.org/xmlns");
  $myNamespace->SetAttributes(foo=>"bar",
                              bob=>"vila");
  $stream = XML::Stream->new;
  $stream->Connect(name=>"foo.bar.org",
                   port=>1234,
                   namespace=>"foo:bar",
                   namespaces=>[ $myNamespace ]);
  #
  # The above Connect will send the following as the opening string
  # of the stream to foo.bar.org:1234...
  #
  #   <stream:stream
  #    xmlns:stream="http://etherx.jabber.org/streams"
  #    to="foo.bar.org"
  #    xmlns="foo:bar"
  #    xmlns:mynamespace="http://www.mynamespace.org/xmlns"
  #    mynamespace:foo="bar"
  #    mynamespace:bob="vila">
  #
```

## AUTHOR

Written by Ryan Eatmon in February 2000 Idea By Thomas Charron in January of 2000 for http://etherx.jabber.org/streams/

Currently maintained by Darian Anthony Patrick.

## COPYRIGHT

Copyright (C) 1998-2004 Jabber Software Foundation http://jabber.org/

This module licensed under the LGPL, version 2.1.
