# str

## Call Signature

> **str**(): [`Column`](https://stage.docs.arkiv.network/typescript-sdk/api-reference/main/type-aliases/column/)\<`"str"`, `false`, `false`, `false`\>

Defined in: [src/schema/values.ts:311](https://github.com/Arkiv-Network/arkiv-sdk-js/blob/d464c8dce16c3b8c472479ac5aae9d14344eb067/src/schema/values.ts#L311)

A `str` column, indexed for equality and prefix (`STARTSWITH`) matching once `.indexed()`.

### Returns

[`Column`](https://stage.docs.arkiv.network/typescript-sdk/api-reference/main/type-aliases/column/)\<`"str"`, `false`, `false`, `false`\>

## Call Signature

> **str**(`value`): [`StrValue`](https://stage.docs.arkiv.network/typescript-sdk/api-reference/main/type-aliases/strvalue/)

Defined in: [src/schema/values.ts:325](https://github.com/Arkiv-Network/arkiv-sdk-js/blob/d464c8dce16c3b8c472479ac5aae9d14344eb067/src/schema/values.ts#L325)

A UTF-8 string of at most 128 bytes.

The limit is on **bytes**, not characters: a string of 128 emoji does not fit. Any character
is allowed, control characters included. To store raw bytes, use [bytes](https://stage.docs.arkiv.network/typescript-sdk/api-reference/main/functions/bytes/), or hex in a
`str` when they must be indexed.

### Parameters

#### value

`string`

### Returns

[`StrValue`](https://stage.docs.arkiv.network/typescript-sdk/api-reference/main/type-aliases/strvalue/)

### Throws

If the value is not a string, holds a lone surrogate (so it has no
UTF-8 encoding), or exceeds 128 UTF-8 bytes.

### Example

```ts
str("Bob")
```