From 4e9f3d169285127e60dc9e0437925c90600bfe05 Mon Sep 17 00:00:00 2001 From: brain Date: Wed, 25 May 2005 22:01:10 +0000 Subject: Added parameters git-svn-id: http://svn.inspircd.org/repository/trunk/inspircd@1522 e03df62e-2008-0410-955e-edbf42e46eb7 --- docs/man/man3/Extensible.3 | 44 ++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 40 insertions(+), 4 deletions(-) (limited to 'docs/man/man3/Extensible.3') diff --git a/docs/man/man3/Extensible.3 b/docs/man/man3/Extensible.3 index d36912f60..2018cd126 100644 --- a/docs/man/man3/Extensible.3 +++ b/docs/man/man3/Extensible.3 @@ -1,4 +1,4 @@ -.TH "Extensible" 3 "24 May 2005" "InspIRCd" \" -*- nroff -*- +.TH "Extensible" 3 "25 May 2005" "InspIRCd" \" -*- nroff -*- .ad l .nh .SH NAME @@ -49,13 +49,49 @@ Definition at line 50 of file base.h. .PP .SS "bool Extensible::Extend (std::string key, char * p)" .PP -Extend an Extensible class. You must provide a key to store the data as, and a void* to the data (typedef VoidPointer) The data will be inserted into the map. If the data already exists, you may not insert it twice, \fBExtensible::Extend\fP will return false in this case. On successful extension, Extend returns true. +Extend an Extensible class. \fBParameters:\fP +.RS 4 +\fIkey\fP The key parameter is an arbitary string which identifies the extension data +.br +\fIp\fP This parameter is a pointer to any data you wish to associate with the object +.RE +.PP +You must provide a key to store the data as, and a void* to the data (typedef VoidPointer) The data will be inserted into the map. If the data already exists, you may not insert it twice, \fBExtensible::Extend\fP will return false in this case. +.PP +\fBReturns:\fP +.RS 4 +Returns true on success, false if otherwise +.RE +.PP + .SS "char* Extensible::GetExt (std::string key)" .PP -Get an extension item. You must provide a key name, which is case sensitive. If you provide a non-existent key name, the function returns NULL, otherwise a pointer to the item referenced by the key is returned. +Get an extension item. \fBParameters:\fP +.RS 4 +\fIkey\fP The key parameter is an arbitary string which identifies the extension data +.RE +.PP +\fBReturns:\fP +.RS 4 +If you provide a non-existent key name, the function returns NULL, otherwise a pointer to the item referenced by the key is returned. +.RE +.PP + .SS "bool Extensible::Shrink (std::string key)" .PP -Shrink an Extensible class. You must provide a key name. The given key name will be removed from the classes data. If you provide a nonexistent key (case is important) then the function will return false. Returns true on success. +Shrink an Extensible class. \fBParameters:\fP +.RS 4 +\fIkey\fP The key parameter is an arbitary string which identifies the extension data +.RE +.PP +You must provide a key name. The given key name will be removed from the classes data. If you provide a nonexistent key (case is important) then the function will return false. +.PP +\fBReturns:\fP +.RS 4 +Returns true on success. +.RE +.PP + .SH "Member Data Documentation" .PP .SS "std::map \fBExtensible::Extension_Items\fP\fC [private]\fP" -- cgit v1.2.3