---
title: NSPositionalSpecifier
framework: foundation
role: symbol
role_heading: Class
path: foundation/nspositionalspecifier
---

# NSPositionalSpecifier

A specifier for an insertion point in a container relative to another object in the container.

## Declaration

```swift
class NSPositionalSpecifier
```

## Overview

Overview Instances of NSPositionalSpecifier specify an insertion point in a container relative to another object in the container, for example, before first word or after paragraph 4. The container is specified by an instance of NSScriptObjectSpecifier. NSPositionalSpecifier objects commonly encapsulate object specifiers used as arguments to the make (create) and move commands and indicate where the created or moved object is to be inserted relative to the object represented by an object specifier. Invoking an accessor method to obtain information about an instance of NSPositionalSpecifier  causes the object to be evaluated if it hasn’t been already. You don’t normally subclass NSPositionalSpecifier.

## Topics

### Initializing a positional specifier

- [init(position:objectSpecifier:)](foundation/nspositionalspecifier/init(position:objectspecifier:).md)

### Accessing information about a positional specifier

- [insertionContainer](foundation/nspositionalspecifier/insertioncontainer.md)
- [insertionIndex](foundation/nspositionalspecifier/insertionindex.md)
- [insertionKey](foundation/nspositionalspecifier/insertionkey.md)
- [insertionReplaces](foundation/nspositionalspecifier/insertionreplaces.md)
- [objectSpecifier](foundation/nspositionalspecifier/objectspecifier.md)
- [position](foundation/nspositionalspecifier/position.md)
- [setInsertionClassDescription(_:)](foundation/nspositionalspecifier/setinsertionclassdescription(_:).md)

### Evaluating a positional specifier

- [evaluate()](foundation/nspositionalspecifier/evaluate().md)

### Constants

- [NSPositionalSpecifier.InsertionPosition](foundation/nspositionalspecifier/insertionposition.md)

## Relationships

### Inherits From

- [NSObject](objectivec/nsobject-swift.class.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)

## See Also

### Object Specifiers

- [NSScriptObjectSpecifier](foundation/nsscriptobjectspecifier.md)
- [NSPropertySpecifier](foundation/nspropertyspecifier.md)
- [NSRandomSpecifier](foundation/nsrandomspecifier.md)
- [NSRangeSpecifier](foundation/nsrangespecifier.md)
- [NSUniqueIDSpecifier](foundation/nsuniqueidspecifier.md)
- [NSWhoseSpecifier](foundation/nswhosespecifier.md)
- [NSNameSpecifier](foundation/nsnamespecifier.md)
- [NSMiddleSpecifier](foundation/nsmiddlespecifier.md)
- [NSIndexSpecifier](foundation/nsindexspecifier.md)
- [NSRelativeSpecifier](foundation/nsrelativespecifier.md)