---

Deprecated Pascal String Utilities Functions

A function identified as deprecated has been superseded and may become unsupported in the future.

Deprecated in Mac OS X v10.4

PLpos

(Deprecated in Mac OS X v10.4. Use Core Foundation strings (CFStrings) instead. See CFString Reference.)

short PLpos (
   ConstStr255Param str1,
   ConstStr255Param searchStr
);

Parameters

str1

str2

Return Value

Discussion

Special Considerations

If you need to convert Pascal strings, you can use functions like CFStringCreateWithPascalString to do so.

Version Notes

Carbon Porting Notes

Availability

• Available in Mac OS X v10.0 and later.
• Deprecated in Mac OS X v10.4.

Declared In

PLStringFuncs.h

PLstrcat

(Deprecated in Mac OS X v10.4. Use Core Foundation strings (CFStrings) instead. See CFString Reference.)

StringPtr PLstrcat (
   StringPtr str,
   ConstStr255Param append
);

Parameters

str1

str2

Return Value

Discussion

Special Considerations

If you need to convert Pascal strings, you can use functions like CFStringCreateWithPascalString to do so.

Version Notes

Carbon Porting Notes

Availability

• Available in Mac OS X v10.0 and later.
• Deprecated in Mac OS X v10.4.

Declared In

PLStringFuncs.h

PLstrchr

(Deprecated in Mac OS X v10.4. Use Core Foundation strings (CFStrings) instead. See CFString Reference.)

Ptr PLstrchr (
   ConstStr255Param str1,
   short ch1
);

Parameters

str1

Return Value

Discussion

Special Considerations

If you need to convert Pascal strings, you can use functions like CFStringCreateWithPascalString to do so.

Version Notes

Carbon Porting Notes

Availability

• Available in Mac OS X v10.0 and later.
• Deprecated in Mac OS X v10.4.

Declared In

PLStringFuncs.h

PLstrcmp

(Deprecated in Mac OS X v10.4. Use Core Foundation strings (CFStrings) instead. See CFString Reference.)

short PLstrcmp (
   ConstStr255Param str1,
   ConstStr255Param str2
);

Parameters

str1

str2

Return Value

Discussion

Special Considerations

If you need to convert Pascal strings, you can use functions like CFStringCreateWithPascalString to do so.

Version Notes

Carbon Porting Notes

Availability

• Available in Mac OS X v10.0 and later.
• Deprecated in Mac OS X v10.4.

Declared In

PLStringFuncs.h

PLstrcpy

(Deprecated in Mac OS X v10.4. Use Core Foundation strings (CFStrings) instead. See CFString Reference.)

StringPtr PLstrcpy (
   StringPtr dest,
   ConstStr255Param source
);

Parameters

str1

str2

Return Value

Discussion

Special Considerations

If you need to convert Pascal strings, you can use functions like CFStringCreateWithPascalString to do so.

Version Notes

Carbon Porting Notes

Availability

• Available in Mac OS X v10.0 and later.
• Deprecated in Mac OS X v10.4.

Related Sample Code

• SoftVDigX

Declared In

PLStringFuncs.h

PLstrlen

(Deprecated in Mac OS X v10.4. Use Core Foundation strings (CFStrings) instead. See CFString Reference.)

short PLstrlen (
   ConstStr255Param str
);

Parameters

str

Return Value

Discussion

Special Considerations

If you need to convert Pascal strings, you can use functions like CFStringCreateWithPascalString to do so.

Version Notes

Carbon Porting Notes

Availability

• Available in Mac OS X v10.0 and later.
• Deprecated in Mac OS X v10.4.

Declared In

PLStringFuncs.h

PLstrncat

(Deprecated in Mac OS X v10.4. Use Core Foundation strings (CFStrings) instead. See CFString Reference.)

StringPtr PLstrncat (
   StringPtr str1,
   ConstStr255Param append,
   short num
);

Parameters

str1

str2

Return Value

Discussion

Special Considerations

If you need to convert Pascal strings, you can use functions like CFStringCreateWithPascalString to do so.

Version Notes

Carbon Porting Notes

Availability

• Available in Mac OS X v10.0 and later.
• Deprecated in Mac OS X v10.4.

Declared In

PLStringFuncs.h

PLstrncmp

(Deprecated in Mac OS X v10.4. Use Core Foundation strings (CFStrings) instead. See CFString Reference.)

short PLstrncmp (
   ConstStr255Param str1,
   ConstStr255Param str2,
   short num
);

Parameters

str1

str2

Return Value

Discussion

Special Considerations

If you need to convert Pascal strings, you can use functions like CFStringCreateWithPascalString to do so.

Version Notes

Carbon Porting Notes

Availability

• Available in Mac OS X v10.0 and later.
• Deprecated in Mac OS X v10.4.

Declared In

PLStringFuncs.h

PLstrncpy

(Deprecated in Mac OS X v10.4. Use Core Foundation strings (CFStrings) instead. See CFString Reference.)

StringPtr PLstrncpy (
   StringPtr dest,
   ConstStr255Param source,
   short num
);

Parameters

str1

str2

Return Value

Discussion

Special Considerations

If you need to convert Pascal strings, you can use functions like CFStringCreateWithPascalString to do so.

Version Notes

Carbon Porting Notes

Availability

• Available in Mac OS X v10.0 and later.
• Deprecated in Mac OS X v10.4.

Declared In

PLStringFuncs.h

PLstrpbrk

(Deprecated in Mac OS X v10.4. Use Core Foundation strings (CFStrings) instead. See CFString Reference.)

Ptr PLstrpbrk (
   ConstStr255Param str1,
   ConstStr255Param charSet
);

Parameters

str1

str2

Return Value

Discussion

Special Considerations

If you need to convert Pascal strings, you can use functions like CFStringCreateWithPascalString to do so.

Version Notes

Carbon Porting Notes

Availability

• Available in Mac OS X v10.0 and later.
• Deprecated in Mac OS X v10.4.

Declared In

PLStringFuncs.h

PLstrrchr

(Deprecated in Mac OS X v10.4. Use Core Foundation strings (CFStrings) instead. See CFString Reference.)

Ptr PLstrrchr (
   ConstStr255Param str1,
   short ch1
);

Parameters

str1

Return Value

Discussion

Special Considerations

If you need to convert Pascal strings, you can use functions like CFStringCreateWithPascalString to do so.

Version Notes

Carbon Porting Notes

Availability

• Available in Mac OS X v10.0 and later.
• Deprecated in Mac OS X v10.4.

Declared In

PLStringFuncs.h

PLstrspn

(Deprecated in Mac OS X v10.4. Use Core Foundation strings (CFStrings) instead. See CFString Reference.)

short PLstrspn (
   ConstStr255Param str1,
   ConstStr255Param charSet
);

Parameters

str1

str2

Return Value

Discussion

Special Considerations

If you need to convert Pascal strings, you can use functions like CFStringCreateWithPascalString to do so.

Version Notes

Carbon Porting Notes

Availability

• Available in Mac OS X v10.0 and later.
• Deprecated in Mac OS X v10.4.

Declared In

PLStringFuncs.h

PLstrstr

(Deprecated in Mac OS X v10.4. Use Core Foundation strings (CFStrings) instead. See CFString Reference.)

Ptr PLstrstr (
   ConstStr255Param str1,
   ConstStr255Param searchStr
);

Parameters

str1

str2

Return Value

Discussion

Special Considerations

If you need to convert Pascal strings, you can use functions like CFStringCreateWithPascalString to do so.

Version Notes

Carbon Porting Notes

Availability

• Available in Mac OS X v10.0 and later.
• Deprecated in Mac OS X v10.4.

Declared In

PLStringFuncs.h

---