Contents

# `String`

| `T` parameter | `&T` parameter | `&mut T` parameter | `T` return value | `Option<T>` parameter | `Option<T>` return value | JavaScript representation |
|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
| Yes | No | No | Yes | Yes | Yes | JavaScript string value |

Copies the string's contents back and forth between the JavaScript
garbage-collected heap and the Wasm linear memory with `TextDecoder` and
`TextEncoder`

> **Note**: Be sure to check out the [documentation for `str`](str.html) to
> learn about some caveats when working with strings between JS and Rust.

## Example Rust Usage

```rust
{{#include ../../../../examples/guide-supported-types-examples/src/string.rs}}
```

## Example JavaScript Usage

```js
{{#include ../../../../examples/guide-supported-types-examples/string.js}}
```

Version data entries

30 entries across 30 versions & 1 rubygems

Version	Path
wasmtime-23.0.2	./ext/cargo-vendor/wasm-bindgen-0.2.89/guide/src/reference/types/string.md
wasmtime-22.0.0	./ext/cargo-vendor/wasm-bindgen-0.2.89/guide/src/reference/types/string.md
wasmtime-21.0.1	./ext/cargo-vendor/wasm-bindgen-0.2.89/guide/src/reference/types/string.md
wasmtime-20.0.2	./ext/cargo-vendor/wasm-bindgen-0.2.89/guide/src/reference/types/string.md
wasmtime-20.0.0	./ext/cargo-vendor/wasm-bindgen-0.2.89/guide/src/reference/types/string.md
wasmtime-18.0.3	./ext/cargo-vendor/wasm-bindgen-0.2.89/guide/src/reference/types/string.md
wasmtime-17.0.1	./ext/cargo-vendor/wasm-bindgen-0.2.89/guide/src/reference/types/string.md
wasmtime-17.0.0	./ext/cargo-vendor/wasm-bindgen-0.2.89/guide/src/reference/types/string.md
wasmtime-16.0.0	./ext/cargo-vendor/wasm-bindgen-0.2.89/guide/src/reference/types/string.md
wasmtime-15.0.1	./ext/cargo-vendor/wasm-bindgen-0.2.89/guide/src/reference/types/string.md
wasmtime-15.0.0	./ext/cargo-vendor/wasm-bindgen-0.2.89/guide/src/reference/types/string.md
wasmtime-14.0.4	./ext/cargo-vendor/wasm-bindgen-0.2.87/guide/src/reference/types/string.md
wasmtime-14.0.3	./ext/cargo-vendor/wasm-bindgen-0.2.87/guide/src/reference/types/string.md
wasmtime-14.0.1	./ext/cargo-vendor/wasm-bindgen-0.2.87/guide/src/reference/types/string.md
wasmtime-14.0.0	./ext/cargo-vendor/wasm-bindgen-0.2.87/guide/src/reference/types/string.md
wasmtime-13.0.0	./ext/cargo-vendor/wasm-bindgen-0.2.87/guide/src/reference/types/string.md
wasmtime-12.0.1	./ext/cargo-vendor/wasm-bindgen-0.2.87/guide/src/reference/types/string.md
wasmtime-12.0.0	./ext/cargo-vendor/wasm-bindgen-0.2.87/guide/src/reference/types/string.md
wasmtime-11.0.0	./ext/cargo-vendor/wasm-bindgen-0.2.87/guide/src/reference/types/string.md
wasmtime-10.0.1	./ext/cargo-vendor/wasm-bindgen-0.2.87/guide/src/reference/types/string.md