Public Member Functions

de::softpro::doc::SignDocAttachment Class Reference

Output of SignDocDocument::getAttachment(). More...

#include <SignDocSDK-cpp.h>

Public Member Functions

 SignDocAttachment ()
 Constructor.
 SignDocAttachment (const SignDocAttachment &aSource)
 Copy constructor.
 ~SignDocAttachment ()
 Destructor.
SignDocAttachmentoperator= (const SignDocAttachment &aSource)
 Assignment operator.
void swap (SignDocAttachment &aOther)
 Efficiently swap this object with another one.
std::string getName (Encoding aEncoding) const
 Get the name of the attachment.
const char * getNameUTF8 () const
 Get the name of the attachment as UTF-8-encoded C string.
std::string getFileName (Encoding aEncoding) const
 Get the file name of the attachment.
const char * getFileNameUTF8 () const
 Get the file name of the attachment as UTF-8-encoded C string.
std::string getDescription (Encoding aEncoding) const
 Get the description of the attachment.
const char * getDescriptionUTF8 () const
 Get the description of the attachment as UTF-8-encoded C string.
int getSize () const
 Get the size (in octets) of the attachment.
int getCompressedSize () const
 Get the compressed size (in octets) of the attachment.
const char * getType () const
 Get the MIME type of the attachment.
const char * getCreationTime () const
 Get the creation time and date of the attachment.
const char * getModificationTime () const
 Get the time and date of the last modification of the attachment.
 SignDocAttachment (SIGNDOC_Attachment *aP)
 Internal function.
SIGNDOC_Attachment * getImpl ()
 Internal function.
const SIGNDOC_Attachment * getImpl () const
 Internal function.
void setImpl (SIGNDOC_Attachment *aP)
 Internal function.

Detailed Description

Output of SignDocDocument::getAttachment().


Constructor & Destructor Documentation

de::softpro::doc::SignDocAttachment::SignDocAttachment (  ) [inline]

Constructor.

de::softpro::doc::SignDocAttachment::SignDocAttachment ( const SignDocAttachment aSource ) [inline]

Copy constructor.

Parameters:
[in]aSourceThe object to be copied.
de::softpro::doc::SignDocAttachment::~SignDocAttachment (  ) [inline]

Destructor.

de::softpro::doc::SignDocAttachment::SignDocAttachment ( SIGNDOC_Attachment *  aP ) [inline]

Internal function.


Member Function Documentation

int de::softpro::doc::SignDocAttachment::getCompressedSize (  ) const [inline]

Get the compressed size (in octets) of the attachment.

Returns:
The compressed size (in octets) of the attachment.
See also:
getSize()
const char* de::softpro::doc::SignDocAttachment::getCreationTime (  ) const [inline]

Get the creation time and date of the attachment.

The returned string will be empty if the creation time and date are missing.

ISO 8601 format is used: yyyy-mm-ddThh:mm:ss, optionally followed by a timezone: Z, +hh:mm, or -hh:mm.

The PDF reference is ambiguous; apparently, the creation time is supposed to be the time and date at which the attachment was the PDF document. Changing the description does not update the modification date/time.

Returns:
The creation time and date of the attachment. This pointer will become invalid when this object is destroyed.
See also:
getModificationTime()
std::string de::softpro::doc::SignDocAttachment::getDescription ( Encoding  aEncoding ) const [inline]

Get the description of the attachment.

The returned string will be empty if the description is missing.

This function throws std::runtime_error if the description cannot be represented using the specified encoding.

Parameters:
[in]aEncodingThe encoding to be used for the return value.
Returns:
The description of the attachment.
See also:
getDescriptionUTF8()
const char* de::softpro::doc::SignDocAttachment::getDescriptionUTF8 (  ) const [inline]

Get the description of the attachment as UTF-8-encoded C string.

The returned string will be empty if the description is missing.

Returns:
The description of the attachment. This pointer will become invalid when this object is destroyed.
See also:
getDescription()
std::string de::softpro::doc::SignDocAttachment::getFileName ( Encoding  aEncoding ) const [inline]

Get the file name of the attachment.

This function throws std::runtime_error if the file name cannot be represented using the specified encoding.

Parameters:
[in]aEncodingThe encoding to be used for the return value.
Returns:
The file name of the attachment.
See also:
getFileNameUTF8()
const char* de::softpro::doc::SignDocAttachment::getFileNameUTF8 (  ) const [inline]

Get the file name of the attachment as UTF-8-encoded C string.

Returns:
The file name of the attachment. This pointer will become invalid when this object is destroyed.
See also:
getFileName()
SIGNDOC_Attachment* de::softpro::doc::SignDocAttachment::getImpl (  ) [inline]

Internal function.

const SIGNDOC_Attachment* de::softpro::doc::SignDocAttachment::getImpl (  ) const [inline]

Internal function.

const char* de::softpro::doc::SignDocAttachment::getModificationTime (  ) const [inline]

Get the time and date of the last modification of the attachment.

Setting the time and date of the last modification of the attachment is optional. The returned string will be empty if the modification time and date are missing.

ISO 8601 format is used: yyyy-mm-ddThh:mm:ss, optionally followed by a timezone: Z, +hh:mm, or -hh:mm.

The PDF reference is ambiguous; apparently, the modification time is supposed to be the time and date of the last modification of the file at the time it was attached. Changing the description does not update the modification date/time.

Returns:
The time and date of the last modification of the attachment. This pointer will become invalid when this object is destroyed.
std::string de::softpro::doc::SignDocAttachment::getName ( Encoding  aEncoding ) const [inline]

Get the name of the attachment.

This function throws std::runtime_error if the name cannot be represented using the specified encoding.

Parameters:
[in]aEncodingThe encoding to be used for the return value.
Returns:
The name of the attachment.
See also:
getNameUTF8()
const char* de::softpro::doc::SignDocAttachment::getNameUTF8 (  ) const [inline]

Get the name of the attachment as UTF-8-encoded C string.

Returns:
The name of the attachment. This pointer will become invalid when this object is destroyed.
See also:
getName()
int de::softpro::doc::SignDocAttachment::getSize (  ) const [inline]

Get the size (in octets) of the attachment.

The return value is -1 if the size of the attachment is not readily available.

Returns:
The size (in octets) of the attachment or -1.
See also:
getCompressedSize()
const char* de::softpro::doc::SignDocAttachment::getType (  ) const [inline]

Get the MIME type of the attachment.

The return string will be empty if the MIME type is missing.

Returns:
The MIME type of the attachment. This pointer will become invalid when this object is destroyed.
SignDocAttachment& de::softpro::doc::SignDocAttachment::operator= ( const SignDocAttachment aSource ) [inline]

Assignment operator.

Parameters:
[in]aSourceThe source object.
void de::softpro::doc::SignDocAttachment::setImpl ( SIGNDOC_Attachment *  aP ) [inline]

Internal function.

void de::softpro::doc::SignDocAttachment::swap ( SignDocAttachment aOther ) [inline]

Efficiently swap this object with another one.

Parameters:
[in]aOtherThe other object.

The documentation for this class was generated from the following file: