# Transform

## reverse 

```dart
String reverse() 
```

The 'reverse' methods reverse the order of characters in a string:

```dart
Strings.reverse('1234');
-> '4321'
```

#### extension

The 'reverse' method is available as an extension to the String class.

```dart
'1234'.reverse();
-> '4321'
```

## toEscaped

```dart
static String toEscaped(String? string, {String Function(int charCode)? encode});
```

The 'toEscaped' escapes the following characters by proceeding them with a leading '\\'

* tab
* newline
* carriage return
* "
* '
* $

```dart
Strings.toEscaped('\t"$Hello"\r\n');
-> r'\t\"\$Hello\"\r\n"
```

If null is passed the 'string' is treated as an empty string and an empty string is returned.

The 'encode' function allows you to encode additional characters. As the string is escaped, 'encode' will be called for each character (except for the noted list above) allowing you to return an alternate encoding for that character.

```dart
Strings.toEscaped('abcd', encode: (character) -> character == 'a' ? 'AAA' : character);
-> AAAbcd
```

#### extension

The toEscaped method is available as an extension method on the String class.

```dart
'$abc'.toEscaped();
-> '\$abc'
```

## toPrintable

```dart
static String toPrintable(String? string);
```

The 'toPrintable' escapes the following characters by proceeding them with a leading '\\'

* tab
* newline
* carriage return

```dart
Strings.toPrintable('\t"$Hello"\r\n');
-> r'\t"$Hello"\r\n"
```

If null is passed the 'string' is treated as an empty string and an empty string is returned.

#### extension

The toPrintable method is available as an extension method on the String class.

```dart
'"$Hello".toPrintable();
-> r'\"$Hello"'
```

## toUnicode

```dart
static String toUnicode(int? charCode) 
```

The 'toUnicode' returns a unicode representation of the charCode. 

```dart
 print(toUnicode(50));
  -> \u0032
```

If null is passed an empty string is returned.


---

# 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://strings.onepub.dev/transform.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.