---
title: withString
framework: kernel
role: pseudoSymbol
path: kernel/osstring/1808306-withstring
---

# withString

Creates and initializes an OSString from another OSString.

## Declaration

```occ
static OSString * withString(
 const OSString *aString); 
```

## Parameters

- `aString`: The OSString object whose contents to copy.

## Return Value

Return Value An instance of OSString representing the same characters as aString, and with a reference count of 1; NULL on failure.

## Overview

Overview The new OSString is a distinct instance from aString, and is not merely the original object with the reference count incremented. Changes to one will not be reflected in the other.

## See Also

### Miscellaneous

- [free](kernel/osstring/1808271-free.md)
- [getChar](kernel/osstring/1808273-getchar.md)
- [getCStringNoCopy](kernel/osstring/1808275-getcstringnocopy.md)
- [getLength](kernel/osstring/1808278-getlength.md)
- [initWithCString](kernel/osstring/1808281-initwithcstring.md)
- [initWithCStringNoCopy](kernel/osstring/1808284-initwithcstringnocopy.md)
- [initWithString](kernel/osstring/1808286-initwithstring.md)
- [isEqualTo(const char *)](kernel/osstring/1808288-isequalto.md)
- [isEqualTo(const OSData *)](kernel/osstring/1808292-isequalto.md)
- [isEqualTo(const OSMetaClassBase *)](kernel/osstring/1808295-isequalto.md)
- [isEqualTo(const OSString *)](kernel/osstring/1808297-isequalto.md)
- [serialize](kernel/osstring/1808298-serialize.md)
- [setChar](kernel/osstring/1808300-setchar.md)
- [withCString](kernel/osstring/1808301-withcstring.md)
- [withCStringNoCopy](kernel/osstring/1808304-withcstringnocopy.md)