---
name: "ACE_Name_Space"
section: "3"
platform: "linux"
package: "libace-doc"
version: "5.0.7-4"
release: "Debian 2.2 (Potato)"
platforms: ["linux"]
url: "https://new.carta.tech/ACE_Name_Space"
---

# ACE\_Name\_Space(3)

Abstract base class that provides an abstract interface to the database without exposing any implemenation details.

## NAME

ACE\_Name\_Space -  Abstract base class that provides an abstract interface to the database without exposing any implemenation details.

## SYNOPSIS

```
#include <ACE/Name_Space.h>
class ACE_Name_Space
{
  public:
    virtual ~ACE_Name_Space (void);
    virtual int bind (
        const ACE_WString &name_in,
        const ACE_WString &value_in,
        const char *type_in = ""
        ) = 0;
    virtual int rebind (
        const ACE_WString &name_in,
        const ACE_WString &value_in,
        const char *type_in = ""
        ) = 0;
    virtual int unbind (const ACE_WString &name_in) = 0;
    virtual int resolve (
        const ACE_WString &name_in,
        ACE_WString &value_out,
        char *&type_out
        ) = 0;
    virtual int list_names (
        ACE_WSTRING_SET &set_out,
        const ACE_WString &pattern_in
        ) = 0;
    virtual int list_values (
        ACE_WSTRING_SET &set_out,
        const ACE_WString &pattern_in
        ) = 0;
    virtual int list_types (
        ACE_WSTRING_SET &set_out,
        const ACE_WString &pattern_in
        ) = 0;
    virtual int list_name_entries (
        ACE_BINDING_SET &set,
        const ACE_WString &pattern
        ) = 0;
    virtual int list_value_entries (
        ACE_BINDING_SET &set,
        const ACE_WString &pattern
        ) = 0;
    virtual int list_type_entries (
        ACE_BINDING_SET &set,
        const ACE_WString &pattern
        ) = 0;
    virtual void dump (void) const = 0;
};
```

## DESCRIPTION

Manages a Naming Service Name Space. Provides the basic methods -- bind, unbind, rebind, find, and listnames.

## PUBLIC MEMBERS

```
virtual ~ACE_Name_Space (void);
```

virtual destructor to ensure destructors of subclasses get called.

```
virtual int bind (
    const ACE_WString &name_in,
    const ACE_WString &value_in,
    const char *type_in = ""
    ) = 0;
```

Bind a new name to a naming context (Wide character strings).

```
virtual int rebind (
    const ACE_WString &name_in,
    const ACE_WString &value_in,
    const char *type_in = ""
    ) = 0;
```

Overwrite the value or type of an existing name in a ACE\_Name\_Space or bind a new name to the context, if it didn't exist yet. (Wide charcter strings interface).

```
virtual int unbind (const ACE_WString &name_in) = 0;
```

Delete a name from a ACE\_Name\_Space (Wide charcter strings Interface).

```
virtual int resolve (
    const ACE_WString &name_in,
    ACE_WString &value_out,
    char *&type_out
    ) = 0;
```

Get value and type of a given name binding (Wide chars).  The caller is responsible for deleting both value\_out and type\_out!

```
virtual int list_names (
    ACE_WSTRING_SET &set_out,
    const ACE_WString &pattern_in
    ) = 0;
```

Get a set of names matching a specified pattern (wchars). Matching means the names must begin with the pattern string.

```
virtual int list_values (
    ACE_WSTRING_SET &set_out,
    const ACE_WString &pattern_in
    ) = 0;
```

Get a set of values matching a specified pattern (wchars). Matching means the values must begin with the pattern string.

```
virtual int list_types (
    ACE_WSTRING_SET &set_out,
    const ACE_WString &pattern_in
    ) = 0;
```

Get a set of types matching a specified pattern (wchars). Matching means the types must begin with the pattern string.

```
virtual int list_name_entries (
    ACE_BINDING_SET &set,
    const ACE_WString &pattern
    ) = 0;
```

Get a set of names matching a specified pattern (wchars). Matching means the names must begin with the pattern string. Returns the complete binding associated each pattern match.

```
virtual int list_value_entries (
    ACE_BINDING_SET &set,
    const ACE_WString &pattern
    ) = 0;
```

Get a set of values matching a specified pattern (wchars). Matching means the values must begin with the pattern string. Returns the complete binding associated each pattern match.

```
virtual int list_type_entries (
    ACE_BINDING_SET &set,
    const ACE_WString &pattern
    ) = 0;
```

Get a set of types matching a specified pattern (wchars). Matching means the types must begin with the pattern string. Returns the complete binding associated each pattern match.

```
virtual void dump (void) const = 0;
```

Dump the state of the object

## AUTHOR

Prashant Jain

## LIBRARY

ACE