mirror of
https://gitlab.com/freepascal.org/fpc/source.git
synced 2025-06-22 17:18:15 +02:00
6c9f7b25a9
o translation of SearchKit has been added
o a new version of the AuthorizationCallbacks record has been introduced.
Backward compatibility has been ensured by renaming the old
AuthorizationCallbacks record type to AuthorizationCallbacks0, naming
the new one AuthorizationCallbacks1 and turning AuthorizationCallbacks
into a variant record with version0 and version1 fields of those types.
Similarly, there are now kAuthorizationPluginInterfaceVersion0 and
kAuthorizationPluginInterfaceVersion1 constants, with
kAuthorizationPluginInterfaceVersion aliasing
the new kAuthorizationPluginInterfaceVersion1
o the CGFunctionCreate and CGFunctionEvaluateCallback signatures have been
corrected (mantis #28484)
git-svn-id: trunk@31334 -
771 lines
24 KiB
ObjectPascal
771 lines
24 KiB
ObjectPascal
{
|
|
File: CarbonCore/PLStringFuncs.h
|
|
|
|
Contains: Pascal string manipulation routines that parallel ANSI C string.h
|
|
The contents of this header file are deprecated.
|
|
|
|
Copyright: © 1999-2011 by Apple Inc. All rights reserved.
|
|
}
|
|
{
|
|
Modified for use with Free Pascal
|
|
Version 308
|
|
Please report any bugs to <gpc@microbizz.nl>
|
|
}
|
|
|
|
{$ifc not defined MACOSALLINCLUDE or not MACOSALLINCLUDE}
|
|
{$mode macpas}
|
|
{$packenum 1}
|
|
{$macro on}
|
|
{$inline on}
|
|
{$calling mwpascal}
|
|
|
|
unit PLStringFuncs;
|
|
interface
|
|
{$setc UNIVERSAL_INTERFACES_VERSION := $0400}
|
|
{$setc GAP_INTERFACES_VERSION := $0308}
|
|
|
|
{$ifc not defined USE_CFSTR_CONSTANT_MACROS}
|
|
{$setc USE_CFSTR_CONSTANT_MACROS := TRUE}
|
|
{$endc}
|
|
|
|
{$ifc defined CPUPOWERPC and defined CPUI386}
|
|
{$error Conflicting initial definitions for CPUPOWERPC and CPUI386}
|
|
{$endc}
|
|
{$ifc defined FPC_BIG_ENDIAN and defined FPC_LITTLE_ENDIAN}
|
|
{$error Conflicting initial definitions for FPC_BIG_ENDIAN and FPC_LITTLE_ENDIAN}
|
|
{$endc}
|
|
|
|
{$ifc not defined __ppc__ and defined CPUPOWERPC32}
|
|
{$setc __ppc__ := 1}
|
|
{$elsec}
|
|
{$setc __ppc__ := 0}
|
|
{$endc}
|
|
{$ifc not defined __ppc64__ and defined CPUPOWERPC64}
|
|
{$setc __ppc64__ := 1}
|
|
{$elsec}
|
|
{$setc __ppc64__ := 0}
|
|
{$endc}
|
|
{$ifc not defined __i386__ and defined CPUI386}
|
|
{$setc __i386__ := 1}
|
|
{$elsec}
|
|
{$setc __i386__ := 0}
|
|
{$endc}
|
|
{$ifc not defined __x86_64__ and defined CPUX86_64}
|
|
{$setc __x86_64__ := 1}
|
|
{$elsec}
|
|
{$setc __x86_64__ := 0}
|
|
{$endc}
|
|
{$ifc not defined __arm__ and defined CPUARM}
|
|
{$setc __arm__ := 1}
|
|
{$elsec}
|
|
{$setc __arm__ := 0}
|
|
{$endc}
|
|
{$ifc not defined __arm64__ and defined CPUAARCH64}
|
|
{$setc __arm64__ := 1}
|
|
{$elsec}
|
|
{$setc __arm64__ := 0}
|
|
{$endc}
|
|
|
|
{$ifc defined cpu64}
|
|
{$setc __LP64__ := 1}
|
|
{$elsec}
|
|
{$setc __LP64__ := 0}
|
|
{$endc}
|
|
|
|
|
|
{$ifc defined __ppc__ and __ppc__ and defined __i386__ and __i386__}
|
|
{$error Conflicting definitions for __ppc__ and __i386__}
|
|
{$endc}
|
|
|
|
{$ifc defined __ppc__ and __ppc__}
|
|
{$setc TARGET_CPU_PPC := TRUE}
|
|
{$setc TARGET_CPU_PPC64 := FALSE}
|
|
{$setc TARGET_CPU_X86 := FALSE}
|
|
{$setc TARGET_CPU_X86_64 := FALSE}
|
|
{$setc TARGET_CPU_ARM := FALSE}
|
|
{$setc TARGET_CPU_ARM64 := FALSE}
|
|
{$setc TARGET_OS_MAC := TRUE}
|
|
{$setc TARGET_OS_IPHONE := FALSE}
|
|
{$setc TARGET_IPHONE_SIMULATOR := FALSE}
|
|
{$setc TARGET_OS_EMBEDDED := FALSE}
|
|
{$elifc defined __ppc64__ and __ppc64__}
|
|
{$setc TARGET_CPU_PPC := FALSE}
|
|
{$setc TARGET_CPU_PPC64 := TRUE}
|
|
{$setc TARGET_CPU_X86 := FALSE}
|
|
{$setc TARGET_CPU_X86_64 := FALSE}
|
|
{$setc TARGET_CPU_ARM := FALSE}
|
|
{$setc TARGET_CPU_ARM64 := FALSE}
|
|
{$setc TARGET_OS_MAC := TRUE}
|
|
{$setc TARGET_OS_IPHONE := FALSE}
|
|
{$setc TARGET_IPHONE_SIMULATOR := FALSE}
|
|
{$setc TARGET_OS_EMBEDDED := FALSE}
|
|
{$elifc defined __i386__ and __i386__}
|
|
{$setc TARGET_CPU_PPC := FALSE}
|
|
{$setc TARGET_CPU_PPC64 := FALSE}
|
|
{$setc TARGET_CPU_X86 := TRUE}
|
|
{$setc TARGET_CPU_X86_64 := FALSE}
|
|
{$setc TARGET_CPU_ARM := FALSE}
|
|
{$setc TARGET_CPU_ARM64 := FALSE}
|
|
{$ifc defined(iphonesim)}
|
|
{$setc TARGET_OS_MAC := FALSE}
|
|
{$setc TARGET_OS_IPHONE := TRUE}
|
|
{$setc TARGET_IPHONE_SIMULATOR := TRUE}
|
|
{$elsec}
|
|
{$setc TARGET_OS_MAC := TRUE}
|
|
{$setc TARGET_OS_IPHONE := FALSE}
|
|
{$setc TARGET_IPHONE_SIMULATOR := FALSE}
|
|
{$endc}
|
|
{$setc TARGET_OS_EMBEDDED := FALSE}
|
|
{$elifc defined __x86_64__ and __x86_64__}
|
|
{$setc TARGET_CPU_PPC := FALSE}
|
|
{$setc TARGET_CPU_PPC64 := FALSE}
|
|
{$setc TARGET_CPU_X86 := FALSE}
|
|
{$setc TARGET_CPU_X86_64 := TRUE}
|
|
{$setc TARGET_CPU_ARM := FALSE}
|
|
{$setc TARGET_CPU_ARM64 := FALSE}
|
|
{$ifc defined(iphonesim)}
|
|
{$setc TARGET_OS_MAC := FALSE}
|
|
{$setc TARGET_OS_IPHONE := TRUE}
|
|
{$setc TARGET_IPHONE_SIMULATOR := TRUE}
|
|
{$elsec}
|
|
{$setc TARGET_OS_MAC := TRUE}
|
|
{$setc TARGET_OS_IPHONE := FALSE}
|
|
{$setc TARGET_IPHONE_SIMULATOR := FALSE}
|
|
{$endc}
|
|
{$setc TARGET_OS_EMBEDDED := FALSE}
|
|
{$elifc defined __arm__ and __arm__}
|
|
{$setc TARGET_CPU_PPC := FALSE}
|
|
{$setc TARGET_CPU_PPC64 := FALSE}
|
|
{$setc TARGET_CPU_X86 := FALSE}
|
|
{$setc TARGET_CPU_X86_64 := FALSE}
|
|
{$setc TARGET_CPU_ARM := TRUE}
|
|
{$setc TARGET_CPU_ARM64 := FALSE}
|
|
{ will require compiler define when/if other Apple devices with ARM cpus ship }
|
|
{$setc TARGET_OS_MAC := FALSE}
|
|
{$setc TARGET_OS_IPHONE := TRUE}
|
|
{$setc TARGET_IPHONE_SIMULATOR := FALSE}
|
|
{$setc TARGET_OS_EMBEDDED := TRUE}
|
|
{$elifc defined __arm64__ and __arm64__}
|
|
{$setc TARGET_CPU_PPC := FALSE}
|
|
{$setc TARGET_CPU_PPC64 := FALSE}
|
|
{$setc TARGET_CPU_X86 := FALSE}
|
|
{$setc TARGET_CPU_X86_64 := FALSE}
|
|
{$setc TARGET_CPU_ARM := FALSE}
|
|
{$setc TARGET_CPU_ARM64 := TRUE}
|
|
{ will require compiler define when/if other Apple devices with ARM cpus ship }
|
|
{$setc TARGET_OS_MAC := FALSE}
|
|
{$setc TARGET_OS_IPHONE := TRUE}
|
|
{$setc TARGET_IPHONE_SIMULATOR := FALSE}
|
|
{$setc TARGET_OS_EMBEDDED := TRUE}
|
|
{$elsec}
|
|
{$error __ppc__ nor __ppc64__ nor __i386__ nor __x86_64__ nor __arm__ nor __arm64__ is defined.}
|
|
{$endc}
|
|
|
|
{$ifc defined __LP64__ and __LP64__ }
|
|
{$setc TARGET_CPU_64 := TRUE}
|
|
{$elsec}
|
|
{$setc TARGET_CPU_64 := FALSE}
|
|
{$endc}
|
|
|
|
{$ifc defined FPC_BIG_ENDIAN}
|
|
{$setc TARGET_RT_BIG_ENDIAN := TRUE}
|
|
{$setc TARGET_RT_LITTLE_ENDIAN := FALSE}
|
|
{$elifc defined FPC_LITTLE_ENDIAN}
|
|
{$setc TARGET_RT_BIG_ENDIAN := FALSE}
|
|
{$setc TARGET_RT_LITTLE_ENDIAN := TRUE}
|
|
{$elsec}
|
|
{$error Neither FPC_BIG_ENDIAN nor FPC_LITTLE_ENDIAN are defined.}
|
|
{$endc}
|
|
{$setc ACCESSOR_CALLS_ARE_FUNCTIONS := TRUE}
|
|
{$setc CALL_NOT_IN_CARBON := FALSE}
|
|
{$setc OLDROUTINENAMES := FALSE}
|
|
{$setc OPAQUE_TOOLBOX_STRUCTS := TRUE}
|
|
{$setc OPAQUE_UPP_TYPES := TRUE}
|
|
{$setc OTCARBONAPPLICATION := TRUE}
|
|
{$setc OTKERNEL := FALSE}
|
|
{$setc PM_USE_SESSION_APIS := TRUE}
|
|
{$setc TARGET_API_MAC_CARBON := TRUE}
|
|
{$setc TARGET_API_MAC_OS8 := FALSE}
|
|
{$setc TARGET_API_MAC_OSX := TRUE}
|
|
{$setc TARGET_CARBON := TRUE}
|
|
{$setc TARGET_CPU_68K := FALSE}
|
|
{$setc TARGET_CPU_MIPS := FALSE}
|
|
{$setc TARGET_CPU_SPARC := FALSE}
|
|
{$setc TARGET_OS_UNIX := FALSE}
|
|
{$setc TARGET_OS_WIN32 := FALSE}
|
|
{$setc TARGET_RT_MAC_68881 := FALSE}
|
|
{$setc TARGET_RT_MAC_CFM := FALSE}
|
|
{$setc TARGET_RT_MAC_MACHO := TRUE}
|
|
{$setc TYPED_FUNCTION_POINTERS := TRUE}
|
|
{$setc TYPE_BOOL := FALSE}
|
|
{$setc TYPE_EXTENDED := FALSE}
|
|
{$setc TYPE_LONGLONG := TRUE}
|
|
uses MacTypes;
|
|
{$endc} {not MACOSALLINCLUDE}
|
|
|
|
|
|
{$ifc TARGET_OS_MAC}
|
|
|
|
{
|
|
* PLstrcmp() *** DEPRECATED ***
|
|
*
|
|
* Deprecated:
|
|
* use CFString instead.
|
|
*
|
|
* Summary:
|
|
* Compare two pascal strings
|
|
*
|
|
* Discussion:
|
|
* This function compares two pascal strings, and returns a value <
|
|
* 0 if the first string is lexicographically less than the second
|
|
* string, or 0 if the two strings are identical, or a value > 0 if
|
|
* the first string is lexicographically greater than the second.
|
|
* This function should be deprecated since pascal strings are
|
|
* obsolete on MacOSX and CFString should be used instead.
|
|
*
|
|
* Mac OS X threading:
|
|
* Thread safe
|
|
* Thread safe provided no other thread is modifying str1 or str2.
|
|
*
|
|
* Parameters:
|
|
*
|
|
* str1:
|
|
* the first pascal string
|
|
*
|
|
* str2:
|
|
* the second pascal string
|
|
*
|
|
* Result:
|
|
* This function returns an integer greater than, equal to, or less
|
|
* than 0, according as the string str1 is greater than, equal to,
|
|
* or less than the string str2. The comparison is done using
|
|
* unsigned characters, so that `\200' is greater than `\0'.
|
|
*
|
|
* Availability:
|
|
* Mac OS X: in version 10.0 and later in CoreServices.framework but deprecated in 10.4
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
|
* Non-Carbon CFM: not available
|
|
}
|
|
function PLstrcmp( const (*var*) str1: Str255; const (*var*) str2: Str255 ): SInt16; external name '_PLstrcmp';
|
|
(* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_4, __IPHONE_NA, __IPHONE_NA) *)
|
|
|
|
|
|
{
|
|
* PLstrncmp() *** DEPRECATED ***
|
|
*
|
|
* Deprecated:
|
|
* use CFString instead.
|
|
*
|
|
* Summary:
|
|
* Compare two pascal strings
|
|
*
|
|
* Discussion:
|
|
* This function compares two pascal strings, and returns a value <
|
|
* 0 if the first string is lexicographically less than the second
|
|
* string, or 0 if the two strings are identical, or a value > 0 if
|
|
* the first string is lexicographically greater than the second.
|
|
* This function compares not more than num characters of either
|
|
* string, even if their lengths are greater than num. Two strings
|
|
* whose first num characters are identical will return 0 when
|
|
* compared. This function should be deprecated since pascal strings
|
|
* are obsolete on MacOSX and CFString should be used instead.
|
|
*
|
|
* Mac OS X threading:
|
|
* Thread safe
|
|
* Thread safe provided no other thread is modifying str1 or str2.
|
|
*
|
|
* Parameters:
|
|
*
|
|
* str1:
|
|
* the first pascal string
|
|
*
|
|
* str2:
|
|
* the second pascal string
|
|
*
|
|
* num:
|
|
* the maximum number of characters to compare
|
|
*
|
|
* Result:
|
|
* This function returns an integer greater than, equal to, or less
|
|
* than 0, according as the string str1 is greater than, equal to,
|
|
* or less than the string str2. The comparison is done using
|
|
* unsigned characters, so that `\200' is greater than `\0'.
|
|
*
|
|
* Availability:
|
|
* Mac OS X: in version 10.0 and later in CoreServices.framework but deprecated in 10.4
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
|
* Non-Carbon CFM: not available
|
|
}
|
|
function PLstrncmp( const (*var*) str1: Str255; const (*var*) str2: Str255; num: SInt16 ): SInt16; external name '_PLstrncmp';
|
|
(* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_4, __IPHONE_NA, __IPHONE_NA) *)
|
|
|
|
|
|
{
|
|
* PLstrcpy() *** DEPRECATED ***
|
|
*
|
|
* Deprecated:
|
|
* use CFString instead.
|
|
*
|
|
* Summary:
|
|
* Copy a pascal string
|
|
*
|
|
* Discussion:
|
|
* This function copies the string source to dest (including the
|
|
* initial length byte ). The caller must ensure that neither source
|
|
* or dest are NULL, and that dest is large enough to hold the
|
|
* entire contents of source. This function should be deprecated
|
|
* since pascal strings are obsolete on MacOSX and CFString should
|
|
* be used instead.
|
|
*
|
|
* Mac OS X threading:
|
|
* Thread safe
|
|
*
|
|
* Parameters:
|
|
*
|
|
* dest:
|
|
* the destination pascal string
|
|
*
|
|
* source:
|
|
* the source pascal string
|
|
*
|
|
* Result:
|
|
* This function returns dest.
|
|
*
|
|
* Availability:
|
|
* Mac OS X: in version 10.0 and later in CoreServices.framework but deprecated in 10.4
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
|
* Non-Carbon CFM: not available
|
|
}
|
|
function PLstrcpy( dest: StringPtr; const (*var*) source: Str255 ): StringPtr; external name '_PLstrcpy';
|
|
(* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_4, __IPHONE_NA, __IPHONE_NA) *)
|
|
|
|
|
|
{
|
|
* PLstrncpy() *** DEPRECATED ***
|
|
*
|
|
* Deprecated:
|
|
* use CFString instead.
|
|
*
|
|
* Summary:
|
|
* Copy a pascal string
|
|
*
|
|
* Discussion:
|
|
* This function copies the string source to dest (including the
|
|
* initial length byte ), provided the length of source is <= num.
|
|
* If the length of source is > num, then the first num characters
|
|
* of source are copied into dest, and the length of dest is set to
|
|
* num. The caller must ensure that neither source or dest are
|
|
* NULL, and that dest is large enough to hold the entire contents
|
|
* of source. This function should be deprecated since pascal
|
|
* strings are obsolete on MacOSX and CFString should be used
|
|
* instead.
|
|
*
|
|
* Mac OS X threading:
|
|
* Thread safe
|
|
* Thread safe provided no other thread is modifying source.
|
|
*
|
|
* Parameters:
|
|
*
|
|
* dest:
|
|
* the destination pascal string
|
|
*
|
|
* source:
|
|
* the source pascal string
|
|
*
|
|
* num:
|
|
* the maximum number of bytes to copy
|
|
*
|
|
* Result:
|
|
* This function returns dest.
|
|
*
|
|
* Availability:
|
|
* Mac OS X: in version 10.0 and later in CoreServices.framework but deprecated in 10.4
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
|
* Non-Carbon CFM: not available
|
|
}
|
|
function PLstrncpy( dest: StringPtr; const (*var*) source: Str255; num: SInt16 ): StringPtr; external name '_PLstrncpy';
|
|
(* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_4, __IPHONE_NA, __IPHONE_NA) *)
|
|
|
|
|
|
{
|
|
* PLstrcat() *** DEPRECATED ***
|
|
*
|
|
* Deprecated:
|
|
* use CFString instead.
|
|
*
|
|
* Summary:
|
|
* Append a pascal string to another pascal string
|
|
*
|
|
* Discussion:
|
|
* This function append a copy of the pascal string append to the
|
|
* end of the pascal string str. If the length of str plus the
|
|
* length of append is greater than 255 ( the maximum size of a
|
|
* pascal string ) then only enough characters are copied to str to
|
|
* reach the 255 character limit, and the length of str is set to
|
|
* 255. The caller must ensure that neither str nor append are
|
|
* NULL, and that str is large enough to hold the entire contents of
|
|
* append. This function should be deprecated since pascal strings
|
|
* are obsolete on MacOSX and CFString should be used instead.
|
|
*
|
|
* Mac OS X threading:
|
|
* Thread safe
|
|
* Thread safe provided no other thread is modifying str or append.
|
|
*
|
|
* Parameters:
|
|
*
|
|
* str:
|
|
* the destination pascal string
|
|
*
|
|
* append:
|
|
* the pascal string to append
|
|
*
|
|
* Result:
|
|
* This function returns s.
|
|
*
|
|
* Availability:
|
|
* Mac OS X: in version 10.0 and later in CoreServices.framework but deprecated in 10.4
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
|
* Non-Carbon CFM: not available
|
|
}
|
|
function PLstrcat( str: StringPtr; const (*var*) append: Str255 ): StringPtr; external name '_PLstrcat';
|
|
(* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_4, __IPHONE_NA, __IPHONE_NA) *)
|
|
|
|
|
|
{
|
|
* PLstrncat() *** DEPRECATED ***
|
|
*
|
|
* Deprecated:
|
|
* use CFString instead.
|
|
*
|
|
* Summary:
|
|
* Append up to num bytes of a pascal string to another pascal string
|
|
*
|
|
* Discussion:
|
|
* This function append up to the first num bytes of the pascal
|
|
* string append to the end of the pascal string s. If the length
|
|
* of str plus the length of append is greater than 255 ( the
|
|
* maximum size of a pascal string ) then only enough characters are
|
|
* copied to str to reach the 255 character limit, and the length of
|
|
* str is set to 255. The caller must ensure that neither str nor
|
|
* append are NULL, and that str is large enough to hold the entire
|
|
* contents of append. This function should be deprecated since
|
|
* pascal strings are obsolete on MacOSX and CFString should be used
|
|
* instead.
|
|
*
|
|
* Mac OS X threading:
|
|
* Thread safe
|
|
* Thread safe provided no other thread is modifying str1 or append.
|
|
*
|
|
* Parameters:
|
|
*
|
|
* str1:
|
|
* the destination pascal string
|
|
*
|
|
* append:
|
|
* the pascal string to append
|
|
*
|
|
* num:
|
|
* the maximum number of bytes of append to append onto s
|
|
*
|
|
* Result:
|
|
* This function returns str.
|
|
*
|
|
* Availability:
|
|
* Mac OS X: in version 10.0 and later in CoreServices.framework but deprecated in 10.4
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
|
* Non-Carbon CFM: not available
|
|
}
|
|
function PLstrncat( str1: StringPtr; const (*var*) append: Str255; num: SInt16 ): StringPtr; external name '_PLstrncat';
|
|
(* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_4, __IPHONE_NA, __IPHONE_NA) *)
|
|
|
|
|
|
{
|
|
* PLstrchr() *** DEPRECATED ***
|
|
*
|
|
* Deprecated:
|
|
* use CFString instead.
|
|
*
|
|
* Summary:
|
|
* Return a pointer to the first occurrence of ch1 in str.
|
|
*
|
|
* Discussion:
|
|
* The PLstrrchr() function locates the first occurrence of ch1
|
|
* (converted to an unsigned char) in the string s. If ch1 does not
|
|
* occur in the string, this returns NULL. This function should be
|
|
* deprecated since pascal strings are obsolete on MacOSX and
|
|
* CFString should be used instead.
|
|
*
|
|
* Mac OS X threading:
|
|
* Thread safe
|
|
* Thread safe provided no other thread is modifying str1.
|
|
*
|
|
* Parameters:
|
|
*
|
|
* str1:
|
|
* the pascal string
|
|
*
|
|
* ch1:
|
|
* the character to find
|
|
*
|
|
* Result:
|
|
* A pointer to the first occurrence of ch1 in str1, or NULL.
|
|
*
|
|
* Availability:
|
|
* Mac OS X: in version 10.0 and later in CoreServices.framework but deprecated in 10.4
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
|
* Non-Carbon CFM: not available
|
|
}
|
|
function PLstrchr( const (*var*) str1: Str255; ch1: SInt16 ): Ptr; external name '_PLstrchr';
|
|
(* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_4, __IPHONE_NA, __IPHONE_NA) *)
|
|
|
|
|
|
{
|
|
* PLstrrchr() *** DEPRECATED ***
|
|
*
|
|
* Deprecated:
|
|
* use CFString instead.
|
|
*
|
|
* Summary:
|
|
* Return a pointer to the last occurrence of ch1 in str.
|
|
*
|
|
* Discussion:
|
|
* The PLstrrchr() function locates the last occurrence of ch1
|
|
* (converted to an unsigned char) in the string s. If ch1 does not
|
|
* occur in the string, this returns NULL. This function should be
|
|
* deprecated since pascal strings are obsolete on MacOSX and
|
|
* CFString should be used instead.
|
|
*
|
|
* Mac OS X threading:
|
|
* Thread safe
|
|
* Thread safe provided no other thread is modifying str1.
|
|
*
|
|
* Parameters:
|
|
*
|
|
* str1:
|
|
* the pascal string
|
|
*
|
|
* ch1:
|
|
* the character to find
|
|
*
|
|
* Result:
|
|
* A pointer to the last occurrence of ch1 in str1, or NULL.
|
|
*
|
|
* Availability:
|
|
* Mac OS X: in version 10.0 and later in CoreServices.framework but deprecated in 10.4
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
|
* Non-Carbon CFM: not available
|
|
}
|
|
function PLstrrchr( const (*var*) str1: Str255; ch1: SInt16 ): Ptr; external name '_PLstrrchr';
|
|
(* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_4, __IPHONE_NA, __IPHONE_NA) *)
|
|
|
|
|
|
{
|
|
* PLstrpbrk() *** DEPRECATED ***
|
|
*
|
|
* Deprecated:
|
|
* use CFString instead.
|
|
*
|
|
* Summary:
|
|
* Return a pointer to the first occurrence in str of any character
|
|
* in charSet.
|
|
*
|
|
* Discussion:
|
|
* The PLstrpbrk() function returns a pointer to the first
|
|
* occurrence in str of any character in searchStr. If none of the
|
|
* characters in searchStr can be found in str, then NULL is
|
|
* returned. This function should be deprecated since pascal strings
|
|
* are obsolete on MacOSX and CFString should be used instead.
|
|
*
|
|
* Mac OS X threading:
|
|
* Thread safe
|
|
* Thread safe provided no other thread is modifying str1 or charSet.
|
|
*
|
|
* Parameters:
|
|
*
|
|
* str1:
|
|
* the pascal string
|
|
*
|
|
* charSet:
|
|
* the character to find
|
|
*
|
|
* Result:
|
|
* A pointer to the first occurrence of any character in charSet in
|
|
* str1, or NULL.
|
|
*
|
|
* Availability:
|
|
* Mac OS X: in version 10.0 and later in CoreServices.framework but deprecated in 10.4
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
|
* Non-Carbon CFM: not available
|
|
}
|
|
function PLstrpbrk( const (*var*) str1: Str255; const (*var*) charSet: Str255 ): Ptr; external name '_PLstrpbrk';
|
|
(* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_4, __IPHONE_NA, __IPHONE_NA) *)
|
|
|
|
|
|
{
|
|
* PLstrspn() *** DEPRECATED ***
|
|
*
|
|
* Deprecated:
|
|
* use CFString instead.
|
|
*
|
|
* Summary:
|
|
* Spans the initial part of str1 as long as the characters from
|
|
* str1 occur in string charset
|
|
*
|
|
* Discussion:
|
|
* The PLstrspn() function spans the initial part of the pascal
|
|
* string str1 as long as the characters from s occur in string
|
|
* charset. In effect, this returns a count of the number of
|
|
* characters at the beginning of the pascal string str1 which are
|
|
* in charset. This function should be deprecated since pascal
|
|
* strings are obsolete on MacOSX and CFString should be used
|
|
* instead.
|
|
*
|
|
* Mac OS X threading:
|
|
* Thread safe
|
|
* Thread safe provided no other thread is modifying str1 or charSet.
|
|
*
|
|
* Parameters:
|
|
*
|
|
* str1:
|
|
* the pascal string
|
|
*
|
|
* charSet:
|
|
* the character to find
|
|
*
|
|
* Result:
|
|
* The count of characters at the beginning of str1 which are in
|
|
* charSet.
|
|
*
|
|
* Availability:
|
|
* Mac OS X: in version 10.0 and later in CoreServices.framework but deprecated in 10.4
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
|
* Non-Carbon CFM: not available
|
|
}
|
|
function PLstrspn( const (*var*) str1: Str255; const (*var*) charSet: Str255 ): SInt16; external name '_PLstrspn';
|
|
(* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_4, __IPHONE_NA, __IPHONE_NA) *)
|
|
|
|
|
|
{
|
|
* PLstrstr() *** DEPRECATED ***
|
|
*
|
|
* Deprecated:
|
|
* use CFString instead.
|
|
*
|
|
* Summary:
|
|
* Returns a pointer to the first occurrence of searchStr in str1
|
|
*
|
|
* Discussion:
|
|
* The PLstrstr() function returns a pointer to the first occurrence
|
|
* of searchStr in str1, or NULL if searchStr does not exist in
|
|
* str1. This function should be deprecated since pascal strings are
|
|
* obsolete on MacOSX and CFString should be used instead.
|
|
*
|
|
* Mac OS X threading:
|
|
* Thread safe
|
|
* Thread safe provided no other thread is modifying str1 or
|
|
* searchStr.
|
|
*
|
|
* Parameters:
|
|
*
|
|
* str1:
|
|
* the pascal string
|
|
*
|
|
* searchStr:
|
|
* the string to find
|
|
*
|
|
* Result:
|
|
* The count of characters at the beginning of str1 which are in
|
|
* charSet.
|
|
*
|
|
* Availability:
|
|
* Mac OS X: in version 10.0 and later in CoreServices.framework but deprecated in 10.4
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
|
* Non-Carbon CFM: not available
|
|
}
|
|
function PLstrstr( const (*var*) str1: Str255; const (*var*) searchStr: Str255 ): Ptr; external name '_PLstrstr';
|
|
(* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_4, __IPHONE_NA, __IPHONE_NA) *)
|
|
|
|
|
|
{
|
|
* PLstrlen() *** DEPRECATED ***
|
|
*
|
|
* Deprecated:
|
|
* use CFString instead.
|
|
*
|
|
* Summary:
|
|
* Returns the length of the pascal string
|
|
*
|
|
* Discussion:
|
|
* The PLstrlen() function returns the length of the pascal string
|
|
* str. This function should be deprecated since pascal strings are
|
|
* obsolete on MacOSX and CFString should be used instead.
|
|
*
|
|
* Mac OS X threading:
|
|
* Thread safe
|
|
* Thread safe provided no other thread is modifying str.
|
|
*
|
|
* Parameters:
|
|
*
|
|
* str:
|
|
* the pascal string
|
|
*
|
|
* Result:
|
|
* The length of the pascal string str.
|
|
*
|
|
* Availability:
|
|
* Mac OS X: in version 10.0 and later in CoreServices.framework but deprecated in 10.4
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
|
* Non-Carbon CFM: not available
|
|
}
|
|
function PLstrlen( const (*var*) str: Str255 ): SInt16; external name '_PLstrlen';
|
|
(* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_4, __IPHONE_NA, __IPHONE_NA) *)
|
|
|
|
|
|
{
|
|
* PLpos() *** DEPRECATED ***
|
|
*
|
|
* Deprecated:
|
|
* use CFString instead.
|
|
*
|
|
* Summary:
|
|
* Returns the offset to the first occurrence of searchStr in str1
|
|
*
|
|
* Discussion:
|
|
* The PLpos() function returns the offset of the string searchStr
|
|
* in str1, or 0 if searchStr does not occur in str1. For example,
|
|
* if str1 is "\pHello World" and searchStr is "\pWorld", then this
|
|
* function will return the value 7. This function should be
|
|
* deprecated since pascal strings are obsolete on MacOSX and
|
|
* CFString should be used instead.
|
|
*
|
|
* Mac OS X threading:
|
|
* Thread safe
|
|
* Thread safe provided no other thread is modifying str1 or
|
|
* searchStr.
|
|
*
|
|
* Parameters:
|
|
*
|
|
* str1:
|
|
* the pascal string
|
|
*
|
|
* searchStr:
|
|
* the string to find
|
|
*
|
|
* Result:
|
|
* The count of characters at the beginning of str1 which are in
|
|
* charSet.
|
|
*
|
|
* Availability:
|
|
* Mac OS X: in version 10.0 and later in CoreServices.framework but deprecated in 10.4
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
|
* Non-Carbon CFM: not available
|
|
}
|
|
function PLpos( const (*var*) str1: Str255; const (*var*) searchStr: Str255 ): SInt16; external name '_PLpos';
|
|
(* __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_4, __IPHONE_NA, __IPHONE_NA) *)
|
|
|
|
{$endc} {TARGET_OS_MAC}
|
|
{$ifc not defined MACOSALLINCLUDE or not MACOSALLINCLUDE}
|
|
|
|
end.
|
|
{$endc} {not MACOSALLINCLUDE}
|