arrange {tidybulk} | R Documentation

## Arrange rows by column values

### Description

'arrange()' order the rows of a data frame rows by the values of selected columns.

Unlike other dplyr verbs, 'arrange()' largely ignores grouping; you need to explicit mention grouping variables (or use 'by_group = TRUE') in order to group by them, and functions of variables are evaluated once per data frame, not once per group.

### Usage

    arrange(.data, ..., .by_group = FALSE)

    ## Default S3 method:
    arrange(.data, ..., .by_group = FALSE)

### Arguments

`.data` | A data frame, data frame extension (e.g. a tibble), or a lazy data frame (e.g. from dbplyr or dtplyr). See *Methods*, below, for more details.
`...` | <['tidy-eval'][dplyr_tidy_eval]> Variables, or functions or variables. Use [desc()] to sort a variable in descending order.
`.by_group` | If 'TRUE', will sort first by grouping variable. Applies to grouped data frames only.

### Details

## Locales The sort order for character vectors will depend on the collating sequence of the locale in use: see [locales()].

## Missing values Unlike base sorting with 'sort()', 'NA' are: * always sorted to the end for local data, even when wrapped with 'desc()'. * treated differently for remote data, depending on the backend.

### Value

An object of the same type as '.data'.

* All rows appear in the output, but (usually) in a different place. * Columns are not modified. * Groups are not modified. * Data frame attributes are preserved.

### Methods

This function is a **generic**, which means that packages can provide implementations (methods) for other classes. See the documentation of individual methods for extra arguments and differences in behaviour.

The following methods are currently available in loaded packages:

### See Also

Other single table verbs: `filter()`, `mutate()`, `rename()`, `summarise()`

### Examples

    `%>%` = magrittr::`%>%`
    arrange(mtcars, cyl, disp)
    arrange(mtcars, desc(disp))

    # grouped arrange ignores groups
    by_cyl <- mtcars %>% group_by(cyl)
    by_cyl %>% arrange(desc(wt))
    # Unless you specifically ask:
    by_cyl %>% arrange(desc(wt), .by_group = TRUE)

[Package tidybulk version 0.99.23 Index]