QCA::MemoryRegion

#include <QtCrypto>

Inheritance diagram for QCA::MemoryRegion:

Public Member Functions

 MemoryRegion (const char *str)
 
 MemoryRegion (const QByteArray &from)
 
 MemoryRegion (const MemoryRegion &from)
 
const char & at (int index) const
 
const char * constData () const
 
const char * data () const
 
bool isEmpty () const
 
bool isNull () const
 
bool isSecure () const
 
MemoryRegionoperator= (const MemoryRegion &from)
 
MemoryRegionoperator= (const QByteArray &from)
 
int size () const
 
QByteArray toByteArray () const
 

Protected Member Functions

 MemoryRegion (bool secure)
 
 MemoryRegion (int size, bool secure)
 
 MemoryRegion (const QByteArray &from, bool secure)
 
char & at (int index)
 
char * data ()
 
bool resize (int size)
 
void set (const QByteArray &from, bool secure)
 
void setSecure (bool secure)
 

Detailed Description

Array of bytes that may be optionally secured.

This class is mostly unusable on its own. Either use it as a SecureArray subclass or call toByteArray() to convert to QByteArray.

Note that this class is implicitly shared (that is, copy on write).

Examples:
aes-cmac.cpp.

Definition at line 90 of file qca_tools.h.

Constructor & Destructor Documentation

QCA::MemoryRegion::MemoryRegion ( const char *  str)

Constructs a new Memory Region from a null terminated character array.

Parameters
strpointer to the array of data to copy
QCA::MemoryRegion::MemoryRegion ( const QByteArray from)

Constructs a new MemoryRegion from the data in a byte array.

Parameters
fromthe QByteArray to copy from
QCA::MemoryRegion::MemoryRegion ( const MemoryRegion from)

Standard copy constructor.

Parameters
fromthe MemoryRegion to copy from
QCA::MemoryRegion::MemoryRegion ( bool  secure)
protected

Create a memory region, optionally using secure storage.

Parameters
secureif this is true, the memory region will use secure storage.
Note
This will create a memory region without any content (i.e. both isNull() and isEmpty() will return true.
QCA::MemoryRegion::MemoryRegion ( int  size,
bool  secure 
)
protected

Create a memory region, optionally using secure storage.

Parameters
sizethe number of bytes in the memory region.
secureif this is true, the memory region will use secure storage.
QCA::MemoryRegion::MemoryRegion ( const QByteArray from,
bool  secure 
)
protected

Create a memory region, optionally using secure storage.

This constructor variant allows you to initialize the memory region from an existing array.

Parameters
fromthe byte array to copy from.
secureif this is true, the memory region will use secure storage.

Member Function Documentation

const char& QCA::MemoryRegion::at ( int  index) const

Obtain the value of the memory location at the specified position.

Parameters
indexthe offset into the memory region.
Note
The contents of a memory region are between 0 and size()-1. The content at position size() is always a null terminator.
char& QCA::MemoryRegion::at ( int  index)
protected

Obtain the value of the memory location at the specified position.

Parameters
indexthe offset into the memory region.
Note
The contents of a memory region are between 0 and size()-1. The content at position size() is always a null terminator.
const char* QCA::MemoryRegion::constData ( ) const

Convert the contents of the memory region to a C-compatible character array.

This consists of size() bytes, followed by a null terminator.

See also
toByteArray for an alternative approach.
data which is equivalent to this method
const char* QCA::MemoryRegion::data ( ) const

Convert the contents of the memory region to a C-compatible character array.

This consists of size() bytes, followed by a null terminator.

See also
toByteArray for an alternative approach.
constData, which is equivalent to this method, but avoids the possibility that the compiler picks the wrong version.
char* QCA::MemoryRegion::data ( )
protected

Convert the contents of the memory region to a C-compatible character array.

This consists of size() bytes, followed by a null terminator.

bool QCA::MemoryRegion::isEmpty ( ) const

Returns true if the size of the memory region is zero.

bool QCA::MemoryRegion::isNull ( ) const

Test if the MemoryRegion is null (i.e.

was created as a null array, and hasn't been resized).

This is probably not what you are trying to do. If you are trying to determine whether there are any bytes in the array, use isEmpty() instead.

bool QCA::MemoryRegion::isSecure ( ) const

Test if the MemoryRegion is using secure memory, or not.

In this context, memory is secure if it will not be paged out to disk.

Returns
true if the memory region is secure
MemoryRegion& QCA::MemoryRegion::operator= ( const MemoryRegion from)

Standard assignment operator.

Parameters
fromthe MemoryRegion to copy from
MemoryRegion& QCA::MemoryRegion::operator= ( const QByteArray from)

Standard assignment operator.

Parameters
fromthe QByteArray to copy from
bool QCA::MemoryRegion::resize ( int  size)
protected

Resize the memory region to the specified size.

Parameters
sizethe new size of the region.
void QCA::MemoryRegion::set ( const QByteArray from,
bool  secure 
)
protected

Modify the memory region to match a specified byte array.

This resizes the memory region as required to match the byte array size.

Parameters
fromthe byte array to copy from.
secureif this is true, the memory region will use secure storage.
void QCA::MemoryRegion::setSecure ( bool  secure)
protected

Convert the memory region to use the specified memory type.

This may involve copying data from secure to insecure storage, or from insecure to secure storage.

Parameters
secureif true, use secure memory; otherwise use insecure memory.
int QCA::MemoryRegion::size ( ) const

Returns the number of bytes in the memory region.

QByteArray QCA::MemoryRegion::toByteArray ( ) const

Convert this memory region to a byte array.

Note
For secure data, this will make it insecure
See also
data() and constData() for other ways to convert to an "accessible" format.
Examples:
saslclient.cpp, and saslserver.cpp.

The documentation for this class was generated from the following file:
This file is part of the KDE documentation.
Documentation copyright © 1996-2020 The KDE developers.
Generated on Tue Dec 1 2020 23:04:15 by doxygen 1.8.11 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.