glibmm: Glib::ByteArray Class Reference

glibmm 2.38.1

- Main Page
- Related Pages
- Modules
- Namespaces
- Classes
- Examples

- Class List
- Class Index
- Class Hierarchy
- Class Members

Public Types | Public Member Functions | Static Public Member Functions | Protected Member Functions | Related Functions | List of all members
Glib::ByteArray Class Reference

ByteArray - Arrays of bytes. More...

`#include <glibmm/bytearray.h>`

## Public Types
typedef sigc::slot< int, const guint8*, const guint8* > | SlotCompare
| A Slot type to compare two elements in the array. More...

## Public Member Functions
void | reference () const
| Increment the reference count for this object. More...
void | unreference () const
| Decrement the reference count for this object. More...
GByteArray* | gobj ()
| Provides access to the underlying C instance. More...
const GByteArray* | gobj () const
| Provides access to the underlying C instance. More...
GByteArray* | gobj_copy () const
| Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. More...
Glib::RefPtr< ByteArray > | append (const guint8* data, guint len)
| Adds the given bytes to the end of the ByteArray. More...
Glib::RefPtr< ByteArray > | prepend (const guint8* data, guint len)
| Adds the given data to the start of the ByteArray. More...
guint | size () const
| Gets the size of the byte array. More...
guint8* | get_data ()
| Gets the data of the byte array. More...
const guint8* | get_data () const
| Gets the data of the byte array. More...
Glib::RefPtr< ByteArray > | remove_index (guint index_)
| Removes the byte at the given index from a ByteArray. More...
Glib::RefPtr< ByteArray > | remove_index_fast (guint index_)
| Removes the byte at the given index from a ByteArray. More...
Glib::RefPtr< ByteArray > | remove_range (guint index_, guint length)
| Removes the given number of bytes starting at the given index from a ByteArray. More...
void | sort (const SlotCompare& slot)
| Like g_byte_array_sort(), but the comparison function takes an extra user data argument. More...
Glib::RefPtr< ByteArray > | set_size (guint length)
| Sets the size of the ByteArray, expanding it if necessary. More...

## Static Public Member Functions
static Glib::RefPtr< ByteArray > | create ()
| Creates a new ByteArray with a reference count of 1. More...

## Protected Member Functions
| ByteArray ()
void | operator delete (void*, std::size_t)

## Related Functions
(Note that these are not member functions.)
Glib::RefPtr< Glib::ByteArray > | wrap (GByteArray* object, bool take_copy=false)
| A Glib::wrap() method for this object. More...

## Detailed Description

ByteArray - Arrays of bytes.

ByteArray is a mutable array of bytes, to provide arrays of bytes which grow automatically as elements are added.

To create a new ByteArray use create(). To add elements to a ByteArray, use append(), and prepend().

To set the size of a ByteArray, use set_size().

Since glibmm 2.36:

## Member Typedef Documentation

typedef sigc::slot<int, const guint8*, const guint8*> Glib::ByteArray::SlotCompare

A Slot type to compare two elements in the array.

The slot should return -1 if the first value is less than the second, 0 if they are equal and 1 if the first value is greater than the second.

Slot Prototype:

`int compare(const guint8* first, const guint8* second);`

## Constructor & Destructor Documentation

Glib::ByteArray::ByteArray | ( |  | ) |
| protected

## Member Function Documentation

Glib::RefPtr<ByteArray> Glib::ByteArray::append | ( | const guint8 * | data,
|  | guint | len
| ) |  |

Adds the given bytes to the end of the ByteArray.

The array will grow in size automatically if necessary.

Parameters

  data | The byte data to be added.
  len | The number of bytes to add.

Returns
  The ByteArray.

static Glib::RefPtr<ByteArray> Glib::ByteArray::create | ( |  | ) |
| static

Creates a new ByteArray with a reference count of 1.

Returns
  The new ByteArray.

guint8* Glib::ByteArray::get_data | ( |  | ) |

Gets the data of the byte array.

Returns
  The data.

Since glibmm 2.36:

const guint8* Glib::ByteArray::get_data | ( |  | ) | const

Gets the data of the byte array.

Returns
  The data.

Since glibmm 2.36:

GByteArray* Glib::ByteArray::gobj | ( |  | ) |

Provides access to the underlying C instance.

const GByteArray* Glib::ByteArray::gobj | ( |  | ) | const

Provides access to the underlying C instance.

GByteArray* Glib::ByteArray::gobj_copy | ( |  | ) | const

Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.

void Glib::ByteArray::operator delete | ( | void * | ,
|  | std::size_t |
| ) |  |
| protected

Glib::RefPtr<ByteArray> Glib::ByteArray::prepend | ( | const guint8 * | data,
|  | guint | len
| ) |  |

Adds the given data to the start of the ByteArray.

The array will grow in size automatically if necessary.

Parameters

  data | The byte data to be added.
  len | The number of bytes to add.

Returns
  The ByteArray.

void Glib::ByteArray::reference | ( |  | ) | const

Increment the reference count for this object.

You should never need to do this manually - use the object via a RefPtr instead.

Glib::RefPtr<ByteArray> Glib::ByteArray::remove_index | ( | guint | index_ | ) |

Removes the byte at the given index from a ByteArray.

The following bytes are moved down one place.

Parameters

  index | The index of the byte to remove.

Returns
  The ByteArray.

Glib::RefPtr<ByteArray> Glib::ByteArray::remove_index_fast | ( | guint | index_ | ) |

Removes the byte at the given index from a ByteArray.

The last element in the array is used to fill in the space, so this function does not preserve the order of the ByteArray. But it is faster than g_byte_array_remove_index().

Parameters

  index | The index of the byte to remove.

Returns
  The ByteArray.

Glib::RefPtr<ByteArray> Glib::ByteArray::remove_range | ( | guint | index_,
|  | guint | length
| ) |  |

Removes the given number of bytes starting at the given index from a ByteArray.

The following elements are moved to close the gap.

Since glibmm 2.4:

Parameters

  index | The index of the first byte to remove.
  length | The number of bytes to remove.

Returns
  The ByteArray.

Glib::RefPtr<ByteArray> Glib::ByteArray::set_size | ( | guint | length | ) |

Sets the size of the ByteArray, expanding it if necessary.

Parameters

  length | The new size of the ByteArray.

Returns
  The ByteArray.

guint Glib::ByteArray::size | ( |  | ) | const

Gets the size of the byte array.

Returns
  The size.

Since glibmm 2.36:

void Glib::ByteArray::sort | ( | const SlotCompare& | slot | ) |

Like g_byte_array_sort(), but the comparison function takes an extra user data argument.

Parameters

  compare_func | Comparison function.

void Glib::ByteArray::unreference | ( |  | ) | const

Decrement the reference count for this object.

You should never need to do this manually - use the object via a RefPtr instead.

## Friends And Related Function Documentation

Glib::RefPtr< Glib::ByteArray > wrap | ( | GByteArray * | object,
|  | bool | take_copy = `false`
| ) |  |
| related

A Glib::wrap() method for this object.

Parameters

  object | The C instance.
  take_copy | False if the result should take ownership of the C instance. True if it should take a new copy or ref.

Returns
  A C++ instance that wraps this C instance.