/usr/include/GNUstep/Frameworks/Pantomime.framework/Versions/1.2/CWInternetAddress.h is in libpantomime1.2-dev 1.2.0~pre3+snap20071004+dfsg-4build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 | /*
** CWInternetAddress.h
**
** Copyright (c) 2001-2007
**
** Author: Ludovic Marcotte <ludovic@Sophos.ca>
**
** This library is free software; you can redistribute it and/or
** modify it under the terms of the GNU Lesser General Public
** License as published by the Free Software Foundation; either
** version 2.1 of the License, or (at your option) any later version.
**
** This library is distributed in the hope that it will be useful,
** but WITHOUT ANY WARRANTY; without even the implied warranty of
** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
** Lesser General Public License for more details.
**
** You should have received a copy of the GNU Lesser General Public
** License along with this library; if not, write to the Free Software
** Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
#ifndef _Pantomime_H_CWInternetAddress
#define _Pantomime_H_CWInternetAddress
#import <Foundation/NSCoder.h>
#import <Foundation/NSData.h>
#import <Foundation/NSObject.h>
#import <Foundation/NSString.h>
#include <Pantomime/CWConstants.h>
/*!
@class CWInternetAddress
@abstract Class that wraps support around email addresses.
@discussion This class is used to decode an email address,
as described in RFC2821, and to hold the information
with regard to it.
*/
@interface CWInternetAddress : NSObject <NSCoding>
{
@private
PantomimeRecipientType _type;
NSString *_address;
NSString *_personal;
// Needed for scripting.
id _container;
}
/*!
@method initWithString:
@discussion This method initializes a CWInternetAddress instance
using <i>theString</i> and decodes from it the
personal and address parts of an Internet address.
@param theString The string from which to decode the information.
If nil is passed, the instance is autoreleased
and nil will be returned.
@result The CWInternetAddress instance, nil on error.
*/
- (id) initWithString: (NSString *) theString;
/*!
@method initWithPersonal: address:
@discussion This method is used to initialize a CWInternetAddress
instance using the specified personal and address
part of an Internet address.
@param thePersonal The personal part of the Internet address.
@param theAddress The address part of the Internet address.
@result The CWInternetAddress instance, nil on error.
*/
- (id) initWithPersonal: (NSString *) thePersonal
address: (NSString *) theAddress;
/*!
@method address
@discussion This method is used to obtain the address part
of the receiver.
@result The address part, as a NSString instance.
*/
- (NSString *) address;
/*!
@method setAddress:
@discussion This method is used to set the address part
of the receiver, replacing the previous
value, if any.
@param theAddress The new address part.
*/
- (void) setAddress: (NSString *) theAddress;
/*!
@method personal
@discussion This method is used to obtain the personal part
of the receiver. The personal part is generally
the name of a person, like John Doe.
@result The personal part, as a NSString instance.
*/
- (NSString *) personal;
/*!
@method setPersonal:
@discussion This method is used to set the personal part
of the receiver, replacing the previous
value, if any. The personal part is generally
the name of a person, like John Doe.
@param thePersonal The new personal part.
*/
- (void) setPersonal: (NSString *) thePersonal;
/*!
@method type
@discussion This method is used to obtain the type of
the receiver. Values can be one of the
PantomimeRecipientType enum.
@result The type.
*/
- (PantomimeRecipientType) type;
/*!
@method setType:
@discussion This method is used to set the receiver's type.
The accepted values are the one of the
PantomimeRecipientType enum.
@param theType The new type, which replaces the previous value.
*/
- (void) setType: (PantomimeRecipientType) theType;
/*!
@method stringValue
@discussion This method is used to return the receiver's personal
and address parts in a correctly (ie., RFC2821 safe)
formatted way. No encoding (ie., using quoted-printable)
will be performed on the receiver's personal part).
@result The formatted object.
*/
- (NSString *) stringValue;
/*!
@method dataValue
@discussion This method is used to return the receiver's personal
and address parts in a correctly (ie., RFC2821 safe)
formatted way. Encoding (ie., using quoted-printable)
will be performed on the receiver's personal part).
@result The formatted object.
*/
- (NSData *) dataValue;
/*!
@method compare:
@discussion This method is used to compare anAddress with the receiver
(using -stringValue).
@result The NSComparisonResult value.
*/
- (NSComparisonResult) compare: (id) theAddress;
/*!
@method isEqualToAddress:
@discussion This method is used to compare anAddress with the receiver's
address only.
@result A boolean value
*/
- (BOOL) isEqualToAddress: (CWInternetAddress *) theAddress;
/*!
@method container
@discussion This method is used to get the container for scripting.
@result The container.
*/
- (id) container;
/*!
@method setContainer:
@discussion This method is used to set the container for scripting.
@param theContainer The container for scripting.
*/
- (void) setContainer: (id) theContainer;
@end
/*!
@class ToRecipient
@discussion This class is used to ease scripting in Pantomime.
*/
@interface ToRecipient: CWInternetAddress
@end
/*!
@class CcRecipient
@discussion This class is used to ease scripting in Pantomime.
*/
@interface CcRecipient: CWInternetAddress
@end
/*!
@class BccRecipient
@discussion This class is used to ease scripting in Pantomime.
*/
@interface BccRecipient: CWInternetAddress
@end
#endif // _Pantomime_H_CWInternetAddress
|