File: ACE_Name_Space.3

package info (click to toggle)
ace 5.2.1-1
  • links: PTS
  • area: main
  • in suites: woody
  • size: 26,856 kB
  • ctags: 18,677
  • sloc: cpp: 171,831; makefile: 48,840; sh: 10,192; perl: 8,582; exp: 787; yacc: 387; lex: 140; csh: 20
file content (134 lines) | stat: -rw-r--r-- 6,766 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
.TH ACE_Name_Space 3 "1 Dec 2001" "ACE" \" -*- nroff -*-
.ad l
.nh
.SH NAME
ACE_Name_Space \- Abstract base class that provides an abstract interface to the database without exposing any implemenation details. 
.SH SYNOPSIS
.br
.PP
\fC#include <Name_Space.h>\fR
.PP
Inherited by \fBACE_Local_Name_Space\fR, and \fBACE_Remote_Name_Space\fR.
.PP
.SS Public Methods

.in +1c
.ti -1c
.RI "virtual \fB~ACE_Name_Space\fR (void)"
.br
.RI "\fIvirtual destructor to ensure destructors of subclasses get called.\fR"
.ti -1c
.RI "virtual int \fBbind\fR (const \fBACE_WString\fR &name_in, const \fBACE_WString\fR &value_in, const char *type_in = "") = 0"
.br
.RI "\fIBind a new name to a naming context (Wide character strings).\fR"
.ti -1c
.RI "virtual int \fBrebind\fR (const \fBACE_WString\fR &name_in, const \fBACE_WString\fR &value_in, const char *type_in = "") = 0"
.br
.ti -1c
.RI "virtual int \fBunbind\fR (const \fBACE_WString\fR &name_in) = 0"
.br
.RI "\fIDelete a name from a ACE_Name_Space (Wide charcter strings Interface).\fR"
.ti -1c
.RI "virtual int \fBresolve\fR (const \fBACE_WString\fR &name_in, \fBACE_WString\fR &value_out, char *&type_out) = 0"
.br
.RI "\fIGet value and type of a given name binding (Wide chars). The caller is responsible for deleting both <value_out> and <type_out>!\fR"
.ti -1c
.RI "virtual int \fBlist_names\fR (\fBACE_WSTRING_SET\fR &set_out, const \fBACE_WString\fR &pattern_in) = 0"
.br
.RI "\fIGet a set of names matching a specified pattern (wchars). Matching means the names must begin with the pattern string.\fR"
.ti -1c
.RI "virtual int \fBlist_values\fR (\fBACE_WSTRING_SET\fR &set_out, const \fBACE_WString\fR &pattern_in) = 0"
.br
.RI "\fIGet a set of values matching a specified pattern (wchars). Matching means the values must begin with the pattern string.\fR"
.ti -1c
.RI "virtual int \fBlist_types\fR (\fBACE_WSTRING_SET\fR &set_out, const \fBACE_WString\fR &pattern_in) = 0"
.br
.RI "\fIGet a set of types matching a specified pattern (wchars). Matching means the types must begin with the pattern string.\fR"
.ti -1c
.RI "virtual int \fBlist_name_entries\fR (\fBACE_BINDING_SET\fR &set, const \fBACE_WString\fR &pattern) = 0"
.br
.ti -1c
.RI "virtual int \fBlist_value_entries\fR (\fBACE_BINDING_SET\fR &set, const \fBACE_WString\fR &pattern) = 0"
.br
.ti -1c
.RI "virtual int \fBlist_type_entries\fR (\fBACE_BINDING_SET\fR &set, const \fBACE_WString\fR &pattern) = 0"
.br
.ti -1c
.RI "virtual void \fBdump\fR (void) const = 0"
.br
.RI "\fIDump the state of the object.\fR"
.in -1c
.SH DETAILED DESCRIPTION
.PP 
Abstract base class that provides an abstract interface to the database without exposing any implemenation details.
.PP
.PP
 Manages a Naming Service Name Space. Provides the basic methods -- bind, unbind, rebind, find, and listnames. 
.PP
.SH CONSTRUCTOR & DESTRUCTOR DOCUMENTATION
.PP 
.SS ACE_Name_Space::~ACE_Name_Space (void)\fC [virtual]\fR
.PP
virtual destructor to ensure destructors of subclasses get called.
.PP
.SH MEMBER FUNCTION DOCUMENTATION
.PP 
.SS int ACE_Name_Space::bind (const \fBACE_WString\fR & name_in, const \fBACE_WString\fR & value_in, const char * type_in = "")\fC [pure virtual]\fR
.PP
Bind a new name to a naming context (Wide character strings).
.PP
Reimplemented in \fBACE_Local_Name_Space\fR, and \fBACE_Remote_Name_Space\fR.
.SS void ACE_Name_Space::dump (void) const\fC [pure virtual]\fR
.PP
Dump the state of the object.
.PP
Reimplemented in \fBACE_Local_Name_Space\fR, and \fBACE_Remote_Name_Space\fR.
.SS int ACE_Name_Space::list_name_entries (\fBACE_BINDING_SET\fR & set, const \fBACE_WString\fR & pattern)\fC [pure virtual]\fR
.PP
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. 
.PP
Reimplemented in \fBACE_Local_Name_Space\fR, and \fBACE_Remote_Name_Space\fR.
.SS int ACE_Name_Space::list_names (\fBACE_WSTRING_SET\fR & set_out, const \fBACE_WString\fR & pattern_in)\fC [pure virtual]\fR
.PP
Get a set of names matching a specified pattern (wchars). Matching means the names must begin with the pattern string.
.PP
Reimplemented in \fBACE_Local_Name_Space\fR, and \fBACE_Remote_Name_Space\fR.
.SS int ACE_Name_Space::list_type_entries (\fBACE_BINDING_SET\fR & set, const \fBACE_WString\fR & pattern)\fC [pure virtual]\fR
.PP
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. 
.PP
Reimplemented in \fBACE_Local_Name_Space\fR, and \fBACE_Remote_Name_Space\fR.
.SS int ACE_Name_Space::list_types (\fBACE_WSTRING_SET\fR & set_out, const \fBACE_WString\fR & pattern_in)\fC [pure virtual]\fR
.PP
Get a set of types matching a specified pattern (wchars). Matching means the types must begin with the pattern string.
.PP
Reimplemented in \fBACE_Local_Name_Space\fR, and \fBACE_Remote_Name_Space\fR.
.SS int ACE_Name_Space::list_value_entries (\fBACE_BINDING_SET\fR & set, const \fBACE_WString\fR & pattern)\fC [pure virtual]\fR
.PP
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. 
.PP
Reimplemented in \fBACE_Local_Name_Space\fR, and \fBACE_Remote_Name_Space\fR.
.SS int ACE_Name_Space::list_values (\fBACE_WSTRING_SET\fR & set_out, const \fBACE_WString\fR & pattern_in)\fC [pure virtual]\fR
.PP
Get a set of values matching a specified pattern (wchars). Matching means the values must begin with the pattern string.
.PP
Reimplemented in \fBACE_Local_Name_Space\fR, and \fBACE_Remote_Name_Space\fR.
.SS int ACE_Name_Space::rebind (const \fBACE_WString\fR & name_in, const \fBACE_WString\fR & value_in, const char * type_in = "")\fC [pure virtual]\fR
.PP
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). 
.PP
Reimplemented in \fBACE_Local_Name_Space\fR, and \fBACE_Remote_Name_Space\fR.
.SS int ACE_Name_Space::resolve (const \fBACE_WString\fR & name_in, \fBACE_WString\fR & value_out, char *& type_out)\fC [pure virtual]\fR
.PP
Get value and type of a given name binding (Wide chars). The caller is responsible for deleting both <value_out> and <type_out>!
.PP
Reimplemented in \fBACE_Local_Name_Space\fR, and \fBACE_Remote_Name_Space\fR.
.SS int ACE_Name_Space::unbind (const \fBACE_WString\fR & name_in)\fC [pure virtual]\fR
.PP
Delete a name from a ACE_Name_Space (Wide charcter strings Interface).
.PP
Reimplemented in \fBACE_Local_Name_Space\fR, and \fBACE_Remote_Name_Space\fR.

.SH AUTHOR
.PP 
Generated automatically by Doxygen for ACE from the source code.