/usr/include/mimelib/disptype.h is in libmimelib1-dev 5:1.1.4-2.
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 206 207 208 209 210 211 212 213 214 215 216 217 218 219 | //=============================================================================
// File: disptype.h
// Contents: Declarations for DwDispositionType
// Maintainer: Doug Sauder <dwsauder@fwb.gulf.net>
// WWW: http://www.fwb.gulf.net/~dwsauder/mimepp.html
//
// Copyright (c) 1996, 1997 Douglas W. Sauder
// All rights reserved.
//
// IN NO EVENT SHALL DOUGLAS W. SAUDER BE LIABLE TO ANY PARTY FOR DIRECT,
// INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF
// THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF DOUGLAS W. SAUDER
// HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
//
// DOUGLAS W. SAUDER SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING, BUT
// NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
// PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS ON AN "AS IS"
// BASIS, AND DOUGLAS W. SAUDER HAS NO OBLIGATION TO PROVIDE MAINTENANCE,
// SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
//
//=============================================================================
#ifndef DW_DISPTYPE_H
#define DW_DISPTYPE_H
#ifndef DW_CONFIG_H
#include <mimelib/config.h>
#endif
#ifndef DW_STRING_H
#include <mimelib/string.h>
#endif
#ifndef DW_FIELDBDY_H
#include <mimelib/fieldbdy.h>
#endif
class DwParameter;
//=============================================================================
//+ Name DwDispositionType -- Class representing a MIME content-disposition field body
//+ Description
//. {\tt DwDispositionType} represents a field body for the
//. Content-Disposition header field as described in RFC-1806. This header
//. field specifies whether the content of a message or body part should
//. be displayed automatically to a user. A disposition-type of inline
//. indicates that the content should be displayed; a disposition-type
//. of attachment indicates that it should not be. RFC-1806 specifies
//. that a filename parameter may be optionally included in the field
//. body; the filename parameter suggests a file name for saving the
//. message or body part's content.
//.
//. {\tt DwDispositionType} provides convenience functions that allow you
//. to set or get the disposition-type as an enumerated value, to set or
//. get the filename parameter, or to manage a list of parameters.
//.
//. RFC-1806 specifically states that the Content-Disposition header field
//. is experimental and not a proposed standard.
//=============================================================================
// Last modified 1997-08-23
//+ Noentry ~DwDispositionType _AddParameter EnumToStr StrToEnum
//+ Noentry DeleteParameterList CopyParameterList mDispositionType
//+ Noentry mDispositionTypeStr mFilenameStr mFirstParameter
//+ Noentry PrintDebugInfo _PrintDebugInfo CheckInvariants
class DW_EXPORT DwDispositionType : public DwFieldBody {
public:
DwDispositionType();
DwDispositionType(const DwDispositionType& aDispType);
DwDispositionType(const DwString& aStr, DwMessageComponent* aParent=0);
//. The first constructor is the default constructor, which sets the
//. {\tt DwDispositionType} object's string representation to the empty
//. string and sets its parent to {\tt NULL}.
//.
//. The second constructor is the copy constructor, which performs
//. deep copy of {\tt aDispType}.
//. The parent of the new {\tt DwDispositionType} object is set to
//. {\tt NULL}.
//.
//. The third constructor copies {\tt aStr} to the {\tt DwDispositionType}
//. object's string representation and sets {\tt aParent} as its parent.
//. The virtual member function {\tt Parse()} should be called immediately
//. after this constructor in order to parse the string representation.
//. Unless it is {\tt NULL}, {\tt aParent} should point to an object of
//. a class derived from {\tt DwField}.
virtual ~DwDispositionType();
const DwDispositionType& operator = (const DwDispositionType& aDispType);
//. This is the assignment operator, which performs a deep copy of
//. {\tt aDispType}. The parent node of the {\tt DwDipositionType}
//. object is not changed.
virtual void Parse();
//. This virtual function, inherited from {\tt DwMessageComponent},
//. executes the parse method for {\tt DwDispositionType} objects.
//. It should be called immediately after the string representation
//. is modified and before the parts of the broken-down
//. representation are accessed.
//.
//. This function clears the is-modified flag.
virtual void Assemble();
//. This virtual function, inherited from {\tt DwMessageComponent},
//. executes the assemble method for {\tt DwDispositionType} objects.
//. It should be called whenever one of the object's attributes
//. is changed in order to assemble the string representation from
//. its broken-down representation. It will be called
//. automatically for this object by the parent object's
//. {\tt Assemble()} member function if the is-modified flag is set.
//.
//. This function clears the is-modified flag.
virtual DwMessageComponent* Clone() const;
//. This virtual function, inherited from {\tt DwMessageComponent},
//. creates a new {\tt DwDispositionType} object on the free store that
//. has the same value as this {\tt DwDispositionType} object. The basic
//. idea is that of a virtual copy constructor.
int DispositionType() const;
//. Returns the disposition-type as an enumerated value. Valid
//. enumerated types, which are defined in enum.h, include
//. {\tt DwMime::kDispTypeNull}, {\tt DwMime::kDispTypeUnknown},
//. {\tt DwMime::kDispTypeInline}, and {\tt DwMime::kDispTypeAttachment}.
void SetDispositionType(int aType);
//. Sets the disposition-type from the enumerated value {\tt aType}.
//. Valid enumerated types, which are defined in enum.h, include
//. {\tt DwMime::kDispTypeNull}, {\tt DwMime::kDispTypeUnknown},
//. {\tt DwMime::kDispTypeInline}, and {\tt DwMime::kDispTypeAttachment}.
const DwString& DispositionTypeStr() const;
//. Returns the disposition-type as a string.
void SetDispositionTypeStr(const DwString& aStr);
//. Sets the disposition-type from a string.
const DwString& Filename() const;
//. This convenience function returns the value from the filename
//. parameter, if present. If no filename parameter is present,
//. an empty string is returned.
void SetFilename(const DwString& aStr);
//. This convenience function sets the value of the filename parameter
//. to {\tt aStr}.
DwParameter* FirstParameter() const;
//. Returns the first {\tt DwParameter} object in the list managed by
//. this {\tt DwDispositionType} object, or {\tt NULL} if no parameters are
//. present. Use {\tt DwParameter::Next()} to iterate through the list.
void AddParameter(DwParameter* aParam);
//. Adds a {\tt DwParameter} object to the list managed by this
//. {\tt DwDispositionType} object.
static DwDispositionType* NewDispositionType(const DwString& aStr,
DwMessageComponent* aParent);
//. Creates a new {\tt DwDispositionType} object on the free store.
//. If the static data member {\tt sNewDispositionType} is {\tt NULL},
//. this member function will create a new {\tt DwDispositionType}
//. and return it. Otherwise, {\tt NewDispositionType()} will call
//. the user-supplied function pointed to by {\tt sNewDispositionType},
//. which is assumed to return an object from a class derived from
//. {\tt DwDispositionType}, and return that object.
//+ Var sNewDispositionType
static DwDispositionType* (*sNewDispositionType)(const DwString&,
DwMessageComponent*);
//. If {\tt sNewDispositionType} is not {\tt NULL}, it is assumed to
//. point to a user-supplied function that returns an object from a
//. class derived from {\tt DwDispositionType}.
protected:
void _AddParameter(DwParameter* aParam);
//. Adds a parameter to the list without setting the is-modified flag.
virtual void EnumToStr();
virtual void StrToEnum();
void DeleteParameterList();
void CopyParameterList(DwParameter* aFirst);
int mDispositionType;
DwString mDispositionTypeStr;
DwString mFilenameStr;
DwParameter* mFirstParameter;
private:
static const char* const sClassName;
public:
virtual void PrintDebugInfo(std::ostream& aStrm, int aDepth=0) const;
//. This virtual function, inherited from {\tt DwMessageComponent},
//. prints debugging information about this object to {\tt aStrm}.
//. It will also call {\tt PrintDebugInfo()} for any of its child
//. components down to a level of {\tt aDepth}.
//.
//. This member function is available only in the debug version of
//. the library.
virtual void CheckInvariants() const;
//. Aborts if one of the invariants of the object fails. Use this
//. member function to track down bugs.
//.
//. This member function is available only in the debug version of
//. the library.
protected:
void _PrintDebugInfo(std::ostream& aStrm) const;
};
#endif
|