Documentation

This is machine translation

Translated by Microsoft
Mouse over text to see original. Click the button below to return to the English verison of the page.

flip

Flip order of elements

Syntax

Description

example

B = flip(A) returns array B the same size as A, but with the order of the elements reversed. The dimension that is reordered in B depends on the shape of A:

  • If A is vector, then flip(A) reverses the order of the elements along the length of the vector.

  • If A is a matrix, then flip(A) reverses the elements in each column.

  • If A is an N-D array, then flip(A) operates on the first dimension of A in which the size value is not 1.

example

B = flip(A,dim) reverses the order of the elements in A along dimension dim. For example, if A is a matrix, then flip(A,1) reverses the elements in each column, and flip(A,2) reverses the elements in each row.

Examples

collapse all

Flip String of Characters

A = 'no word, no bond, row on.';
B = flip(A)
B =

.no wor ,dnob on ,drow on

Flip Column Vector

A = [1;2;3];
B = flip(A)
B =

     3
     2
     1

Flip Matrix

Create a diagonal matrix, A.

A = diag([100 200 300])
A =

   100     0     0
     0   200     0
     0     0   300

Flip A without specifying the dim argument.

B = flip(A)
B =

     0     0   300
     0   200     0
   100     0     0

Now, flip A along the second dimension.

B = flip(A,2)
B =

     0     0   100
     0   200     0
   300     0     0

Flip N-D Array

Create a 1-by-3-by-2 array.

A = zeros(1,3,2);
A(:,:,1) = [1 2 3];
A(:,:,2) = [4 5 6];
A
A(:,:,1) =

     1     2     3


A(:,:,2) =

     4     5     6

Flip A without specifying the dim argument.

B = flip(A)
B(:,:,1) =

     3     2     1


B(:,:,2) =

     6     5     4

Now, flip A along the third dimension.

B = flip(A,3)
B(:,:,1) =

     4     5     6


B(:,:,2) =

     1     2     3

Flip Cell Array

Create a 3-by-2 cell array.

A = {'foo',1000; 999,true; 'aaa','bbb'}
A = 

    'foo'    [1000]
    [999]    [   1]
    'aaa'    'bbb' 

Flip A without specifying the dim argument.

B = flip(A)
B = 

    'aaa'    'bbb' 
    [999]    [   1]
    'foo'    [1000]

Now, flip A along the second dimension.

B = flip(A,2)
B = 

    [1000]    'foo'
    [   1]    [999]
    'bbb'     'aaa'

Input Arguments

collapse all

A — Input arrayvector | matrix | array | cell array | table

Input array, specified as a vector, matrix, array, cell array, or table.

Example: [1 2 3 4]

Example: ['abcde']

Example: [1 2; 3 4]

Example: {'abcde',[1 2 3]}

Example: table(rand(1,5),rand(1,5))

dim — Dimension to operate alongpositive integer scalar

Dimension to operate along, specified as a positive integer scalar. If no value is specified, then the default is the first array dimension whose size does not equal 1.

The following illustration shows the difference between dim=1 and dim=2 when A is a matrix.

See Also

| | | |

Introduced in R2013b

Was this topic helpful?