---
title: list()
framework: foundation
role: symbol
role_heading: Type Method
path: foundation/nsappleeventdescriptor/list()
---

# list()

Creates and initializes an empty list descriptor.

## Declaration

```swift
class func list() -> NSAppleEventDescriptor
```

## Return Value

Return Value An empty list descriptor, or nil if an error occurs.

## Discussion

Discussion A list descriptor is a descriptor whose data consists of one or more descriptors. You can add items to the list by calling insert(_:at:) or remove them with remove(at:). Invoking this method is equivalent to allocating an instance of NSAppleEventDescriptor and invoking init(listDescriptor:).

## See Also

### Creating and Initializing Descriptors

- [appleEvent(withEventClass:eventID:targetDescriptor:returnID:transactionID:)](foundation/nsappleeventdescriptor/appleevent(witheventclass:eventid:targetdescriptor:returnid:transactionid:).md)
- [init(boolean:)](foundation/nsappleeventdescriptor/init(boolean:).md)
- [init(enumCode:)](foundation/nsappleeventdescriptor/init(enumcode:).md)
- [init(int32:)](foundation/nsappleeventdescriptor/init(int32:).md)
- [init(string:)](foundation/nsappleeventdescriptor/init(string:).md)
- [init(typeCode:)](foundation/nsappleeventdescriptor/init(typecode:).md)
- [null()](foundation/nsappleeventdescriptor/null().md)
- [record()](foundation/nsappleeventdescriptor/record().md)
- [init(listDescriptor:)](foundation/nsappleeventdescriptor/init(listdescriptor:).md)
- [init(recordDescriptor:)](foundation/nsappleeventdescriptor/init(recorddescriptor:).md)
- [init(aeDescNoCopy:)](foundation/nsappleeventdescriptor/init(aedescnocopy:)-5cioa.md)
- [init(descriptorType:bytes:length:)](foundation/nsappleeventdescriptor/init(descriptortype:bytes:length:).md)
- [init(descriptorType:data:)](foundation/nsappleeventdescriptor/init(descriptortype:data:).md)
- [init(eventClass:eventID:targetDescriptor:returnID:transactionID:)](foundation/nsappleeventdescriptor/init(eventclass:eventid:targetdescriptor:returnid:transactionid:).md)