---
title: "SecRequirementCopyString(_:_:_:)"
framework: security
role: symbol
role_heading: Function
path: "security/secrequirementcopystring(_:_:_:)"
---

# SecRequirementCopyString(_:_:_:)

Converts a code requirement object into text form.

## Declaration

```swift
func SecRequirementCopyString(_ requirement: SecRequirement, _ flags: SecCSFlags, _ text: UnsafeMutablePointer<CFString?>) -> OSStatus
```

## Parameters

- `requirement`: A valid code requirement object.
- `flags`: Optional flags; see doc://com.apple.security/documentation/Security/SecCSFlags for possible values. Pass doc://com.apple.security/documentation/Security/SecCSFlags/kSecCSDefaultFlags for standard behavior.
- `text`: On return, a text representation of the code requirement.

## Return Value

Return Value A result code. See Code Signing Services Result Codes.

## Discussion

Discussion If you use the SecRequirementCreateWithString(_:_:_:) or SecRequirementCreateWithStringAndErrors(_:_:_:_:) function to create a code requirement object from a text string and later use the SecRequirementCopyString(_:_:_:) function to convert the object back to a string, the reconstituted text may differ in formatting, contain different source comments, and perform its validation functions in different order from the original. However, it is guaranteed that that the reconstituted text is functionally identical to the original. That is, recompiling the text using SecRequirementCreateWithString(_:_:_:) will produce a code requirement object that behaves identically to the first one you created.