ostree-ref 3 OSTREE Library
ostree-ref

## Functions

OstreeCollectionRef * | ostree_collection_ref_new ()
OstreeCollectionRef * | ostree_collection_ref_dup ()
void | ostree_collection_ref_free ()
guint | ostree_collection_ref_hash ()
gboolean | ostree_collection_ref_equal ()
OstreeCollectionRef ** | ostree_collection_ref_dupv ()
void | ostree_collection_ref_freev ()

## Types and Values

typedef | OstreeCollectionRefv

## Description

## Functions

### ostree_collection_ref_new ()

    OstreeCollectionRef *
    ostree_collection_ref_new (const gchar *collection_id,
                               const gchar *ref_name);

Create a new OstreeCollectionRef containing (collection_id , ref_name ). If collection_id is `NULL`, this is equivalent to a plain ref name string (not a refspec; no remote name is included), which can be used for non-P2P operations.

#### Parameters

collection_id | a collection ID, or `NULL` for a plain ref. | [nullable]
ref_name | a ref name |

#### Returns

a new OstreeCollectionRef.

[transfer full][nullable]

Since: 2018.6

ostree_collection_ref_new

### ostree_collection_ref_dup ()

    OstreeCollectionRef *
    ostree_collection_ref_dup (const OstreeCollectionRef *ref);

Create a copy of the given ref .

#### Parameters

ref | an OstreeCollectionRef. | [not nullable]

#### Returns

a newly allocated copy of ref .

[transfer full]

Since: 2018.6

ostree_collection_ref_dup

### ostree_collection_ref_free ()

    void
    ostree_collection_ref_free (OstreeCollectionRef *ref);

Free the given ref .

#### Parameters

ref | an OstreeCollectionRef. | [transfer full]

Since: 2018.6

ostree_collection_ref_free

### ostree_collection_ref_hash ()

    guint
    ostree_collection_ref_hash (gconstpointer ref);

Hash the given ref . This function is suitable for use with GHashTable. ref must be non-`NULL`.

#### Parameters

ref | an OstreeCollectionRef. | [not nullable]

#### Returns

hash value for ref

Since: 2018.6

ostree_collection_ref_hash

### ostree_collection_ref_equal ()

    gboolean
    ostree_collection_ref_equal (gconstpointer ref1,
                                 gconstpointer ref2);

Compare ref1 and ref2 and return `TRUE` if they have the same collection ID and ref name, and `FALSE` otherwise. Both ref1 and ref2 must be non-`NULL`.

#### Parameters

ref1 | an OstreeCollectionRef. | [not nullable]
ref2 | another OstreeCollectionRef. | [not nullable]

#### Returns

`TRUE` if ref1 and ref2 are equal, `FALSE` otherwise

Since: 2018.6

ostree_collection_ref_equal

### ostree_collection_ref_dupv ()

    OstreeCollectionRef **
    ostree_collection_ref_dupv (const OstreeCollectionRef * const *refs);

Copy an array of OstreeCollectionRefs, including deep copies of all its elements. refs must be `NULL`-terminated; it may be empty, but must not be `NULL`.

#### Parameters

refs | `NULL`-terminated array of OstreeCollectionRefs. | [array zero-terminated=1]

#### Returns

a newly allocated copy of refs .

[transfer full][array zero-terminated=1]

Since: 2018.6

ostree_collection_ref_dupv

### ostree_collection_ref_freev ()

    void
    ostree_collection_ref_freev (OstreeCollectionRef **refs);

Free the given array of refs , including freeing all its elements. refs must be `NULL`-terminated; it may be empty, but must not be `NULL`.

#### Parameters

refs | an array of OstreeCollectionRefs. | [transfer full][array zero-terminated=1]

Since: 2018.6

ostree_collection_ref_freev

## Types and Values

### OstreeCollectionRefv

    typedef OstreeCollectionRef** OstreeCollectionRefv;

A `NULL`-terminated array of OstreeCollectionRef instances, designed to be used with `g_auto()`:

    g_auto(OstreeCollectionRefv) refs = NULL;

Since: 2018.6

OstreeCollectionRefv