# Slice Array

The slice operator works on both arrays and strings. Like the `jq` equivalent, `.[10:15]` will return a subarray (or substring) of length 5, starting from index 10 inclusive, up to index 15 exclusive. Negative numbers count backwards from the end of the array or string.

You may leave out the first or second number, which will refer to the start or end of the array or string respectively.

## Slicing arrays

Given a sample.yml file of:

```yaml
- cat
- dog
- frog
- cow
```

then

```bash
yq '.[1:3]' sample.yml
```

will output

```yaml
- dog
- frog
```

## Slicing arrays - without the first number

Starts from the start of the array

Given a sample.yml file of:

```yaml
- cat
- dog
- frog
- cow
```

then

```bash
yq '.[:2]' sample.yml
```

will output

```yaml
- cat
- dog
```

## Slicing arrays - without the second number

Finishes at the end of the array

Given a sample.yml file of:

```yaml
- cat
- dog
- frog
- cow
```

then

```bash
yq '.[2:]' sample.yml
```

will output

```yaml
- frog
- cow
```

## Slicing arrays - use negative numbers to count backwards from the end

Given a sample.yml file of:

```yaml
- cat
- dog
- frog
- cow
```

then

```bash
yq '.[1:-1]' sample.yml
```

will output

```yaml
- dog
- frog
```

## Inserting into the middle of an array

using an expression to find the index

Given a sample.yml file of:

```yaml
- cat
- dog
- frog
- cow
```

then

```bash
yq '(.[] | select(. == "dog") | key + 1) as $pos | .[0:($pos)] + ["rabbit"] + .[$pos:]' sample.yml
```

will output

```yaml
- cat
- dog
- rabbit
- frog
- cow
```

## Slicing strings

Given a sample.yml file of:

```yaml
country: Australia
```

then

```bash
yq '.country[0:5]' sample.yml
```

will output

```yaml
Austr
```

## Slicing strings - without the second number

Finishes at the end of the string

Given a sample.yml file of:

```yaml
country: Australia
```

then

```bash
yq '.country[5:]' sample.yml
```

will output

```yaml
alia
```

## Slicing strings - without the first number

Starts from the start of the string

Given a sample.yml file of:

```yaml
country: Australia
```

then

```bash
yq '.country[:5]' sample.yml
```

will output

```yaml
Austr
```

## Slicing strings - use negative numbers to count backwards from the end

Negative indices count from the end of the string

Given a sample.yml file of:

```yaml
country: Australia
```

then

```bash
yq '.country[-5:]' sample.yml
```

will output

```yaml
ralia
```

## Slicing strings - Unicode

Indices are rune-based, so multi-byte characters are handled correctly

Given a sample.yml file of:

```yaml
greeting: héllo
```

then

```bash
yq '.greeting[1:3]' sample.yml
```

will output

```yaml
él
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://mikefarah.gitbook.io/yq/operators/slice-array.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.