---
title: strings.compare() function
description: The strings.compare() function compares the lexicographical order of two strings.
menu:
  v2_0_ref:
    name: strings.compare
    parent: Strings
weight: 301
---

The `strings.compare()` function compares the lexicographical order of two strings.

_**Output data type:** Integer_

```js
import "strings"

strings.compare(v: "a", t: "b")

// returns -1
```

#### Return values
| Comparison | Return value |
|:----------:|:------------:|
| `v < t`    | `-1`         |
| `v == t`   | `0`          |
| `v > t`    | `1`          |

## Parameters

### v
The string value to compare.

_**Data type:** String_

### t
The string value to compare against.

_**Data type:** String_

## Examples

###### Compare the lexicographical order of column values
```js
import "strings"

data
  |> map(fn: (r) => ({
      r with
      _value: strings.compare(v: r.tag1, t: r.tag2)
    })
  )  
```