# NameList

Added in[API level 8](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

# NameList

```
interface NameList
```

|----------------------------------------------------------------------------------------------|
| [org.w3c.dom.NameList](https://developer.android.com/reference/kotlin/org/w3c/dom/NameList#) |

The`NameList`interface provides the abstraction of an ordered collection of parallel pairs of name and namespace values (which could be null values), without defining or constraining how this collection is implemented. The items in the`NameList`are accessible via an integral index, starting from 0.

See also the[Document Object Model (DOM) Level 3 Core Specification](http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407).

## Summary

|                                                                                                                                                                                                                                       Public methods                                                                                                                                                                                                                                       ||
|--------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| abstract[Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html) | [contains](https://developer.android.com/reference/kotlin/org/w3c/dom/NameList#contains(kotlin.String))`(`str:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!`)` Test if a name is part of this`NameList`.                                                                                                                                                |
| abstract[Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html) | [containsNS](https://developer.android.com/reference/kotlin/org/w3c/dom/NameList#containsNS(kotlin.String,%20kotlin.String))`(`namespaceURI:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!`, `name:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!`)` Test if the pair namespaceURI/name is part of this`NameList`. |
| abstract[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)         | [getLength](https://developer.android.com/reference/kotlin/org/w3c/dom/NameList#getLength())`()` The number of pairs (name and namespaceURI) in the list.                                                                                                                                                                                                                                      |
| abstract[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!  | [getName](https://developer.android.com/reference/kotlin/org/w3c/dom/NameList#getName(kotlin.Int))`(`index:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` Returns the`index`th name item in the collection.                                                                                                                                                  |
| abstract[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!  | [getNamespaceURI](https://developer.android.com/reference/kotlin/org/w3c/dom/NameList#getNamespaceURI(kotlin.Int))`(`index:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` Returns the`index`th namespaceURI item in the collection.                                                                                                                          |

## Public methods

### contains

Added in[API level 8](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
abstract fun contains(str: String!): Boolean
```

Test if a name is part of this`NameList`.

|                                                   Parameters                                                   ||
|-------|---------------------------------------------------------------------------------------------------------|
| `str` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!:The name to look for. |

|                                                                 Return                                                                 ||
|------------------------------------------------------------------------------------|----------------------------------------------------|
| [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html) | `true`if the name has been found,`false`otherwise. |

### containsNS

Added in[API level 8](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
abstract fun containsNS(
    namespaceURI: String!, 
    name: String!
): Boolean
```

Test if the pair namespaceURI/name is part of this`NameList`.

|                                                            Parameters                                                            ||
|----------------|------------------------------------------------------------------------------------------------------------------|
| `namespaceURI` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!:The namespace URI to look for. |
| `name`         | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!:The name to look for.          |

|                                                                          Return                                                                          ||
|------------------------------------------------------------------------------------|----------------------------------------------------------------------|
| [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html) | `true`if the pair namespaceURI/name has been found,`false`otherwise. |

### getLength

Added in[API level 8](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
abstract fun getLength(): Int
```

The number of pairs (name and namespaceURI) in the list. The range of valid child node indices is 0 to`length-1`inclusive.  

### getName

Added in[API level 8](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
abstract fun getName(index: Int): String!
```

Returns the`index`th name item in the collection.

|                                                   Parameters                                                   ||
|---------|-------------------------------------------------------------------------------------------------------|
| `index` | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html):Index into the collection. |

|                                                                                                           Return                                                                                                            ||
|-----------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------|
| [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)! | The name at the`index`th position in the`NameList`, or`null`if there is no name for the specified index or if the index is out of range. |

### getNamespaceURI

Added in[API level 8](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
abstract fun getNamespaceURI(index: Int): String!
```

Returns the`index`th namespaceURI item in the collection.

|                                                   Parameters                                                   ||
|---------|-------------------------------------------------------------------------------------------------------|
| `index` | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html):Index into the collection. |

|                                                                                                                Return                                                                                                                ||
|-----------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------|
| [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)! | The namespace URI at the`index`th position in the`NameList`, or`null`if there is no name for the specified index or if the index is out of range. |