---
title: initWithCStringNoCopy
framework: kernel
role: pseudoSymbol
path: kernel/osstring/1808284-initwithcstringnocopy
---

# initWithCStringNoCopy

Initializes an immutable OSString to share the provided C string buffer.

## Declaration

```occ
virtual bool initWithCStringNoCopy(
 const char *cString); 
```

## Parameters

- `cString`: The C string to reference.

## Return Value

Return Value true on success, false on failure.

## Overview

Overview Not for general use. Use the static instance creation method withCStringNoCopy instead. An OSString object initialized with this function does not claim ownership of the C string, but shares it with the caller. When the caller determines that the OSString object has actually been freed, it can safely dispose of the data buffer. Conversely, if it frees the shared data buffer, it must not attempt to use the OSString object and should release it. An OSString object created with this function does not allow changing the string via setChar.

## 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)
- [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)
- [withString](kernel/osstring/1808306-withstring.md)