---
title: "CTFontDescriptorCreateCopyWithSymbolicTraits(_:_:_:)"
framework: coretext
role: symbol
role_heading: Function
path: "coretext/ctfontdescriptorcreatecopywithsymbolictraits(_:_:_:)"
---

# CTFontDescriptorCreateCopyWithSymbolicTraits(_:_:_:)

Creates a copy of the font descriptor with the specified symbolic traits as the original.

## Declaration

```swift
func CTFontDescriptorCreateCopyWithSymbolicTraits(_ original: CTFontDescriptor, _ symTraitValue: CTFontSymbolicTraits, _ symTraitMask: CTFontSymbolicTraits) -> CTFontDescriptor?
```

## Parameters

- `original`: The original font descriptor.
- `symTraitValue`: The value of the symbolic traits.
- `symTraitMask`: The mask bits of the symbolic traits. This parameter represents a bitfield that indicates which traits should be changed and which should be taken from the original font descriptor.

## Return Value

Return Value Returns a new font descriptor reference in the same family with the given symbolic traits, or NULL if no matching font descriptor is found in the system.

## Discussion

Discussion This bitfield of symTraitValue parameter indicates the desired value for the traits specified by the symTraitMask parameter. Used in conjunction, they can allow for trait removal as well as addition.

## See Also

### Creating Font Descriptors

- [CTFontDescriptorCreateWithNameAndSize(_:_:)](coretext/ctfontdescriptorcreatewithnameandsize(_:_:).md)
- [CTFontDescriptorCreateWithAttributes(_:)](coretext/ctfontdescriptorcreatewithattributes(_:).md)
- [CTFontDescriptorCreateCopyWithAttributes(_:_:)](coretext/ctfontdescriptorcreatecopywithattributes(_:_:).md)
- [CTFontDescriptorCreateCopyWithVariation(_:_:_:)](coretext/ctfontdescriptorcreatecopywithvariation(_:_:_:).md)
- [CTFontDescriptorCreateCopyWithFeature(_:_:_:)](coretext/ctfontdescriptorcreatecopywithfeature(_:_:_:).md)
- [CTFontDescriptorCreateCopyWithFamily(_:_:)](coretext/ctfontdescriptorcreatecopywithfamily(_:_:).md)
- [CTFontDescriptorCreateMatchingFontDescriptors(_:_:)](coretext/ctfontdescriptorcreatematchingfontdescriptors(_:_:).md)
- [CTFontDescriptorCreateMatchingFontDescriptor(_:_:)](coretext/ctfontdescriptorcreatematchingfontdescriptor(_:_:).md)