Skip Headers

Oracle® XML API Reference 10g Release 1 (10.1) Part No. B10789-01 |
| Contents

## NamedNodeMapRef Interface

Table 15-17 summarizes the methods of available through `NamedNodeMapRef` interface.

Table 15-17 Summary of NamedNodeMapRef Methods; Dom Package

Function | Summary
--- | ---
NamedNodeMapRef | Constructor
getLength | Get map's length
getNamedItem | Get item given its name
getNamedItemNS | Get item given its namespace URI and local name.
item | Get item given its index.
removeNamedItem | Remove an item given its name.
removeNamedItemNS | Remove the item from the map.
setNamedItem | Add new item to the map.
setNamedItemNS | Set named item to the map.
~NamedNodeMapRef | Default destructor.

### NamedNodeMapRef

Class constructor.

Syntax | Description
--- | ---
    NamedNodeMapRef(
       const NodeRef< Node>& node_ref,
       NamedNodeMap< Node>* mptr);
| Used to create references to a given `NamedNodeMap` node.
    NamedNodeMapRef(
       const NamedNodeMapRef< Node>& mref);
| Copy constructor.

Parameter | Description
--- | ---
    node_ref
| reference to provide the context
    nptr
| referenced node

Returns

`(NamedNodeMapRef)` `Node` reference object

### getLength

Get the length of the map.

Syntax

    ub4 getLength() const;

Returns

`(ub4)` map's length

### getNamedItem

Get the name of the item, given its name.

Syntax

    Node* getNamedItem( oratext* name) const;

Parameter | Description
--- | ---
    name
| name of item

Returns

`(Node*)` pointer to the item

### getNamedItemNS

Get the name of the item, given its namespace URI and local name.

Syntax

    Node* getNamedItemNS(
       oratext* namespaceURI,
       oratext* localName) const;

Parameter | Description
--- | ---
    namespaceURI
| namespace URI of item
    localName
| local name of item

Returns

`(Node*)` pointer to the item

### item

Get item, given its index.

Syntax

    Node* item(
       ub4 index) const;

Parameter | Description
--- | ---
    index
| index of item

Returns

`(Node*)` pointer to the item

### removeNamedItem

Remove the item from the map, given its name.

Syntax

    Node* removeNamedItem(
       oratext* name)
    throw (DOMException);

Parameter | Description
--- | ---
    name
| name of item

Returns

`(Node*)` pointer to the removed item

### removeNamedItemNS

Remove the item from the map, given its namespace URI and local name.

Syntax

    Node* removeNamedItemNS(
       oratext* namespaceURI,
       oratext* localName)
    throw (DOMException);

Parameter | Description
--- | ---
    namespaceURI
| namespace URI of item
    localName
| local name of item

Returns

`(Node*)` pointer to the removed item

### setNamedItem

Add new item to the map.

Syntax

    Node* setNamedItem(
       NodeRef< Node>& newItem)
    throw (DOMException);

Parameter | Description
--- | ---
    newItem
| item set to the map

Returns

`(Node*)` pointer to new item

### setNamedItemNS

Set named item, which is namespace aware, to the map.

Syntax

    Node* setNamedItemNS(
       NodeRef< Node>& newItem)
    throw (DOMException);

Parameter | Description
--- | ---
    newItem
| item set to the map

Returns

`(Node*)` pointer to the item

### ~NamedNodeMapRef

Default destructor.

Syntax

    ~NamedNodeMapRef();