InfAdoptedSplitOperation: libinfinity-0.7 Reference Manual

## InfAdoptedSplitOperation InfAdoptedSplitOperation — Operation wrapping two operations |

## Stability Level

Unstable, unless otherwise indicated

## Functions

InfAdoptedSplitOperation * | inf_adopted_split_operation_new ()
GSList * | inf_adopted_split_operation_unsplit ()
InfAdoptedOperation * | inf_adopted_split_operation_transform_other ()

## Properties

InfAdoptedOperation * | first | Read / Write / Construct Only
InfAdoptedOperation * | second | Read / Write / Construct Only

## Types and Values

struct | InfAdoptedSplitOperation
struct | InfAdoptedSplitOperationClass

## Object Hierarchy

        GObject
        ╰── InfAdoptedSplitOperation

## Implemented Interfaces

InfAdoptedSplitOperation implements InfAdoptedOperation.

## Includes

    #include <libinfinity/adopted/inf-adopted-split-operation.h>

## Description

InfAdoptedSplitOperation is a wrapper around that two InfAdoptedOperations. This is normally not required directly but may be a result of some transformation. It can also be used to atomically perform multiple operations at once.

If A denotes the first operation of the split operation and B denotes the second operation, the split operation applies first A and then B to the document. Note that a split operation is not commutative, i.e. the order of the two operations is important and cannot be interchanged at will. When the second operation, B, is applied, it is assumed that the operation A was already applied before.

The reverse of the split operation (A, B) is (R(B), R(A)) where R indicates the reverse operation. When the split operation is transformed against an operation T, the result is (T A, (A T) B). When another operation T is transformed against the split operation, the result is B (A T). The functions `inf_adopted_operation_revert()`, `inf_adopted_operation_transform()` and `inf_adopted_split_operation_transform_other()` perform these three operations, respectively.

## Functions

### inf_adopted_split_operation_new ()

    InfAdoptedSplitOperation *
    inf_adopted_split_operation_new (InfAdoptedOperation *first,
                                     InfAdoptedOperation *second);

Creates a new InfAdoptedSplitOperation. A split operation is simply a wrapper around two operations (which may in turn be split operations).

[constructor]

#### Parameters

first | one of the InfAdoptedOperations to be wrapped |
second | the other InfAdoptedOperation to be wrapped |

#### Returns

A new InfAdoptedSplitOperation.

[transfer full]

### inf_adopted_split_operation_unsplit ()

    GSList *
    inf_adopted_split_operation_unsplit (InfAdoptedSplitOperation *operation);

Returns a list of the operations contained by the split operation. If the splitted operation are in turn split operations, they will also be unsplitted. The returned list is guarenteed to not contain a InfAdoptedSplitOperation.

#### Parameters

operation | A InfAdoptedSplitOperation. |

#### Returns

A list of operations. Free with `g_slist_free()` when done.

[transfer container][element-type InfAdoptedOperation]

### inf_adopted_split_operation_transform_other ()

    InfAdoptedOperation *
    inf_adopted_split_operation_transform_other
                                   (InfAdoptedSplitOperation *op,
                                    InfAdoptedOperation *other,
                                    InfAdoptedOperation *op_lcs,
                                    InfAdoptedOperation *other_lcs,
                                    gint concurrency_id);

Transforms `other` against `op` .

#### Parameters

op | A InfAdoptedSplitOperation. |
other | An arbitrary InfAdoptedOperation. |
op_lcs | The operation `op` at a previous state, or `NULL`. |
other_lcs | The operation `other` at a previous state, or `NULL`. |
concurrency_id | The concurrency id for the transformation of `other` against `op` . |

#### Returns

The transformed operation.

[transfer full]

## Types and Values

### struct InfAdoptedSplitOperation

    struct InfAdoptedSplitOperation;

InfAdoptedSplitOperation is an opaque data type. You should only access it via the public API functions.

### struct InfAdoptedSplitOperationClass

    struct InfAdoptedSplitOperationClass {
    };

This structure does not contain any public fields.

## Property Details

### The `“first”` property

      “first”                    InfAdoptedOperation *

The first operation of the split operation.

Owner: InfAdoptedSplitOperation

Flags: Read / Write / Construct Only

### The `“second”` property

      “second”                   InfAdoptedOperation *

The second operation of the split operation.

Owner: InfAdoptedSplitOperation

Flags: Read / Write / Construct Only