exercism/rust/reverse-string/README.md

# Reverse String

Welcome to Reverse String on Exercism's Rust Track.
If you need help running the tests or submitting your code, check out `HELP.md`.

## Introduction

Reversing strings (reading them from right to left, rather than from left to right) is a surprisingly common task in programming.

For example, in bioinformatics, reversing the sequence of DNA or RNA strings is often important for various analyses, such as finding complementary strands or identifying palindromic sequences that have biological significance.

## Instructions

Your task is to reverse a given string.

Some examples:

- Turn `"stressed"` into `"desserts"`.
- Turn `"strops"` into `"sports"`.
- Turn `"racecar"` into `"racecar"`.

## Bonus

Test your function on this string: `uüu` and see what happens.
Try to write a function that properly reverses this string.
Hint: grapheme clusters

To get the bonus test to run, remove the ignore flag (`#[ignore]`) from the last test, and execute the tests with:

```bash
cargo test --features grapheme
```

You will need to use external libraries (a `crate` in rust lingo) for the bonus task.
A good place to look for those is [crates.io](https://crates.io/), the official repository of crates.
Please remember that only a limited set of crates is supported by our test runner.
The full list is in [this file](https://github.com/exercism/rust-test-runner/blob/main/local-registry/Cargo.toml) under the section `[dependencies]`.

[Check the documentation](https://doc.rust-lang.org/cargo/guide/dependencies.html) for instructions on how to use external crates in your projects.

## Source

### Created by

- @coriolinus

### Contributed to by

- @cbzehner
- @ccouzens
- @cwhakes
- @efx
- @ErikSchierboom
- @hunger
- @lutostag
- @ocstl
- @PaulT89
- @petertseng
- @rofrol
- @rrredface
- @stringparser
- @TheDarkula
- @xakon
- @ZapAnton

### Based on

Introductory challenge to reverse an input string - https://medium.freecodecamp.org/how-to-reverse-a-string-in-javascript-in-3-different-ways-75e4763c68cb
Rust: completed Hello World, Reverse String, Difference of Squares 2024-08-01 13:21:50 -04:00			`# Reverse String`

			`Welcome to Reverse String on Exercism's Rust Track.`
			If you need help running the tests or submitting your code, check out `HELP.md`.

			`## Introduction`

			`Reversing strings (reading them from right to left, rather than from left to right) is a surprisingly common task in programming.`

			`For example, in bioinformatics, reversing the sequence of DNA or RNA strings is often important for various analyses, such as finding complementary strands or identifying palindromic sequences that have biological significance.`

			`## Instructions`

			`Your task is to reverse a given string.`

			`Some examples:`

			- Turn `"stressed"` into `"desserts"`.
			- Turn `"strops"` into `"sports"`.
			- Turn `"racecar"` into `"racecar"`.

			`## Bonus`

Rust: completed Reverse String again 2024-10-28 22:22:16 -04:00			Test your function on this string: `uüu` and see what happens.
			`Try to write a function that properly reverses this string.`
			`Hint: grapheme clusters`
Rust: completed Hello World, Reverse String, Difference of Squares 2024-08-01 13:21:50 -04:00
Rust: completed Reverse String again 2024-10-28 22:22:16 -04:00			To get the bonus test to run, remove the ignore flag (`#[ignore]`) from the last test, and execute the tests with:
Rust: completed Hello World, Reverse String, Difference of Squares 2024-08-01 13:21:50 -04:00
			```bash
Rust: completed Reverse String again 2024-10-28 22:22:16 -04:00			`cargo test --features grapheme`
Rust: completed Hello World, Reverse String, Difference of Squares 2024-08-01 13:21:50 -04:00			```

Rust: completed Reverse String again 2024-10-28 22:22:16 -04:00			You will need to use external libraries (a `crate` in rust lingo) for the bonus task.
			`A good place to look for those is [crates.io](https://crates.io/), the official repository of crates.`
			`Please remember that only a limited set of crates is supported by our test runner.`
			The full list is in [this file](https://github.com/exercism/rust-test-runner/blob/main/local-registry/Cargo.toml) under the section `[dependencies]`.
Rust: completed Hello World, Reverse String, Difference of Squares 2024-08-01 13:21:50 -04:00
			`[Check the documentation](https://doc.rust-lang.org/cargo/guide/dependencies.html) for instructions on how to use external crates in your projects.`

			`## Source`

			`### Created by`

			`- @coriolinus`

			`### Contributed to by`

			`- @cbzehner`
			`- @ccouzens`
			`- @cwhakes`
			`- @efx`
			`- @ErikSchierboom`
			`- @hunger`
			`- @lutostag`
			`- @ocstl`
			`- @PaulT89`
			`- @petertseng`
			`- @rofrol`
			`- @rrredface`
			`- @stringparser`
			`- @TheDarkula`
			`- @xakon`
			`- @ZapAnton`

			`### Based on`

			`Introductory challenge to reverse an input string - https://medium.freecodecamp.org/how-to-reverse-a-string-in-javascript-in-3-different-ways-75e4763c68cb`