---
title: TECCreateConverterFromPath
framework: Core Services
role: symbol
role_heading: Function
platforms: [macOS 10.0+]
path: coreservices/1571829-teccreateconverterfrompath
---

# TECCreateConverterFromPath

Creates a converter object for a specific conversion path—froma source encoding through intermediate encodings to a destinationencoding—and returns a pointer to it.

## Declaration

```occ
OSStatus TECCreateConverterFromPath(TECObjectRef *newEncodingConverter, const TextEncoding inPath[], ItemCount inEncodings);
```

## Parameters

- `newEncodingConverter`: A pointer to a converter object reference. On return, the reference points to a newly created text converter object.
- `inPath`: An ordered array of text encoding specifications, beginning with the source encoding specification and ending with the destination encoding specification. Each adjacent pair of text encodings must represent a conversion that is supported by the Text Encoding Converter.
- `inEncodings`: The number of text encoding specifications in the inPath array.

## Return Value

Return Value A resultcode. See Result Codes.

## Discussion

Discussion This function is faster than the function  TECCreateConverter  since it does notneed to search for a conversion path. You can use the  TECGetDestinationTextEncodings function to determine each step in the sequence from the sourceto the destination encoding. To remove a converter object, you must call the function  TECDisposeConverter.

## See Also

### Creating and Deleting Converter Objects

- [TECCreateConverter](coreservices/1571815-teccreateconverter.md)
- [TECClearConverterContextInfo](coreservices/1571844-tecclearconvertercontextinfo.md)
- [TECDisposeConverter](coreservices/1571839-tecdisposeconverter.md)
