fliplr

Flip array left to right

Syntax

B = fliplr(A)

Description

B = fliplr(A) returns A with its columns flipped in the left-right direction (that is, about a vertical axis).

If A is a row vector, then fliplr(A) returns a vector of the same length with the order of its elements reversed. If A is a column vector, then fliplr(A) simply returns A. For multidimensional arrays, fliplr operates on the planes formed by the first and second dimensions.

Examples

Flip Row Vector

Create a row vector.

A = 1:10

A = 1×10

     1     2     3     4     5     6     7     8     9    10

Use fliplr to flip the elements of A in the horizontal direction.

B = fliplr(A)

B = 1×10

    10     9     8     7     6     5     4     3     2     1

The order of the elements in B is reversed compared to A.

Flip Cell Array of Characters

Create a 3-by-3 cell array of characters.

A = {'a' 'b' 'c'; 'd' 'e' 'f'; 'g' 'h' 'i'}

A = 3x3 cell
    {'a'}    {'b'}    {'c'}
    {'d'}    {'e'}    {'f'}
    {'g'}    {'h'}    {'i'}

Change the order of the columns in the horizontal direction by using fliplr.

B = fliplr(A)

B = 3x3 cell
    {'c'}    {'b'}    {'a'}
    {'f'}    {'e'}    {'d'}
    {'i'}    {'h'}    {'g'}

The order of the first and third columns of A is switched in B, while the second column remains unchanged.

Flip Multidimensional Array

Create a multidimensional array.

A = cat(3, [1 2; 3 4], [5 6; 7 8])

A = 
A(:,:,1) =

     1     2
     3     4


A(:,:,2) =

     5     6
     7     8

A is an array of size 2-by-2-by-2.

Flip the elements on each page of A in the horizontal direction.

B = fliplr(A)

B = 
B(:,:,1) =

     2     1
     4     3


B(:,:,2) =

     6     5
     8     7

The result, B, is the same size as A, but the horizontal order of the elements is flipped. The operation flips the elements on each page independently.

Input Arguments

A — Input array

vector | matrix | multidimensional array | table | timetable

Input array, specified as a vector, matrix, multidimensional array, table, or timetable.

Data Types: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string | struct | cell | table | timetable | categorical | datetime | duration | calendarDuration

Complex Number Support: Yes

Tips

• fliplr(A) is equivalent to flip(A,2).

• Use the flipud function to flip arrays in the vertical direction (that is, about a horizontal axis).

• The flip function can flip arrays in any direction.

Extended Capabilities

Tall Arrays

Calculate with arrays that have more rows than fit in memory.

The fliplr function fully supports tall arrays. For more information, see Tall Arrays.

C/C++ Code Generation

Generate C and C++ code using MATLAB® Coder™.

Usage notes and limitations:

• Does not support cell arrays.

Thread-Based Environment

Run code in the background using MATLAB® backgroundPool or accelerate code with Parallel Computing Toolbox™ ThreadPool.

This function fully supports thread-based environments. For more information, see Run MATLAB Functions in Thread-Based Environment.

GPU Arrays

Accelerate code by running on a graphics processing unit (GPU) using Parallel Computing Toolbox™.

The fliplr function fully supports GPU arrays. To run the function on a GPU, specify the input data as a gpuArray (Parallel Computing Toolbox). For more information, see Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Distributed Arrays

Partition large arrays across the combined memory of your cluster using Parallel Computing Toolbox™.

This function fully supports distributed arrays. For more information, see Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Version History

Introduced before R2006a