QCA::PGPKey Class Reference

Pretty Good Privacy key. More...

#include <QtCrypto>

Inheritance diagram for QCA::PGPKey:

QCA::Algorithm Collaboration diagram for QCA::PGPKey:

Collaboration graph
[legend]
List of all members.

Public Member Functions

 PGPKey ()
 PGPKey (const QString &fileName)
 PGPKey (const PGPKey &from)
PGPKeyoperator= (const PGPKey &from)
bool isNull () const
QString keyId () const
QString primaryUserId () const
QStringList userIds () const
bool isSecret () const
QDateTime creationDate () const
QDateTime expirationDate () const
QString fingerprint () const
bool inKeyring () const
bool isTrusted () const
QByteArray toArray () const
QString toString () const
bool toFile (const QString &fileName) const

Static Public Member Functions

static PGPKey fromArray (const QByteArray &a, ConvertResult *result=0, const QString &provider=QString())
static PGPKey fromString (const QString &s, ConvertResult *result=0, const QString &provider=QString())
static PGPKey fromFile (const QString &fileName, ConvertResult *result=0, const QString &provider=QString())

Detailed Description

Pretty Good Privacy key.

This holds either a reference to an item in a real PGP keyring, or a standalone item created using the from*() functions.

Note that with the latter method, the key is of no use besides being informational. The key must be in a keyring (that is, inKeyring() == true) to actually do crypto with it.


Constructor & Destructor Documentation

QCA::PGPKey::PGPKey  ) 
 

Create an empty PGP key.

QCA::PGPKey::PGPKey const QString fileName  ) 
 

Create a PGP key from an encoded file.

See also:
fromFile

toFile

QCA::PGPKey::PGPKey const PGPKey from  ) 
 

Standard copy constructor.

Parameters:
from the PGPKey to use as the source


Member Function Documentation

PGPKey& QCA::PGPKey::operator= const PGPKey from  ) 
 

Standard assignment operator.

Parameters:
from the PGPKey to use as the source

bool QCA::PGPKey::isNull  )  const
 

Test if the PGP key is empty (null).

Returns:
true if the PGP key is null

QString QCA::PGPKey::keyId  )  const
 

The Key identification for the PGP key.

QString QCA::PGPKey::primaryUserId  )  const
 

The primary user identification for the key.

QStringList QCA::PGPKey::userIds  )  const
 

The list of all user identifications associated with the key.

bool QCA::PGPKey::isSecret  )  const
 

Test if the PGP key is the secret key.

Returns:
true if the PGP key is the secret key

QDateTime QCA::PGPKey::creationDate  )  const
 

The creation date for the key.

QDateTime QCA::PGPKey::expirationDate  )  const
 

The expiration date for the key.

QString QCA::PGPKey::fingerprint  )  const
 

The key fingerpint.

This will return the PGP fingerprint as a string. It comprises 16 hex digits, without spaces.

bool QCA::PGPKey::inKeyring  )  const
 

Test if this key is in a keyring.

Returns:
true if the key is in a keyring
Note:
keys that are not in a keyring cannot be used for encryption, decryption, signing or verification

bool QCA::PGPKey::isTrusted  )  const
 

Test if the key is trusted.

Returns:
true if the key is trusted

QByteArray QCA::PGPKey::toArray  )  const
 

Export the key to an array.

This will export the key in a binary format (that is, not in an "ascii armoured" form).

See also:
fromArray for a static import method.

toString for an "ascii armoured" export method.

QString QCA::PGPKey::toString  )  const
 

Export the key to a string.

This will export the key in an "ascii armoured" form.

See also:
fromString for a static import method.

toArray for a binary format export method.

bool QCA::PGPKey::toFile const QString fileName  )  const
 

Export the key to a file.

Parameters:
fileName the name of the file to save the key to

static PGPKey QCA::PGPKey::fromArray const QByteArray a,
ConvertResult result = 0,
const QString provider = QString()
[static]
 

Import the key from an array.

Parameters:
a the array to import from
result if not null, this will be set to the result of the import process
provider the provider to use, if a particular provider is required

static PGPKey QCA::PGPKey::fromString const QString s,
ConvertResult result = 0,
const QString provider = QString()
[static]
 

Import the key from a string.

Parameters:
s the string to import from
result if not null, this will be set to the result of the import process
provider the provider to use, if a particular provider is required

static PGPKey QCA::PGPKey::fromFile const QString fileName,
ConvertResult result = 0,
const QString provider = QString()
[static]
 

Import the key from a file.

Parameters:
fileName string containing the name of the file to import from
result if not null, this will be set to the result of the import process
provider the provider to use, if a particular provider is required


The documentation for this class was generated from the following file:
Generated on Fri Jul 6 12:14:59 2007 for Qt Cryptographic Architecture by  doxygen 1.4.6