Null-terminated string (PChar) routines.

This chapter describes the STRINGS unit for Free Pascal. This unit is system independent, and therefore works on all supported platforms.

Allocate memory for a new null-terminated string on the heap StrAlloc reserves memory on the heap for a string with length Len, terminating #0 included, and returns a pointer to it. If there is not enough memory, a run-time error occurs. . Concatenate 2 null-terminated strings. Attaches Source to Dest and returns Dest. No length checking is performed. Compare 2 null-terminated strings, case sensitive.

Compares the null-terminated strings S1 and S2. The result is

  • A negative Longint when S1<S2.
  • 0 when S1=S2.
  • A positive Longint when S1>S2.

For an example, see .

None. Copy a null-terminated string Copy the null terminated string in Source to Dest, and returns a pointer to Dest. Dest needs enough room to contain Source, i.e. StrLen(Source)+1 bytes. No length checking is performed. disposes of a null-terminated string on the heap Removes the string in P from the heap and releases the memory. None. Copy a null-terminated string, return a pointer to the end. Copies the Null-terminated string in Source to Dest, and returns a pointer to the end (i.e. the terminating Null-character) of the copied string. No length checking is performed. Return a pointer to the end of a null-terminated string Returns a pointer to the end of P. (i.e. to the terminating null-character. None. Compare 2 null-terminated strings, case insensitive.

Compares the null-terminated strings S1 and S2, ignoring case. The result is

  • A negative Longint when S1<S2.
  • 0 when S1=S2.
  • A positive Longint when S1>S2.
None. Concatenate 2 null-terminated strings, with length boundary. Adds MaxLen characters from Source to Dest, and adds a terminating null-character. Returns Dest. None. Compare limited number of characters of 2 null-terminated strings

Compares maximum L characters of the null-terminated strings S1 and S2. The result is

  • A negative Longint when S1<S2.
  • 0 when S1=S2.
  • A positive Longint when S1>S2.
None. Copy a null-terminated string, limited in length. Copies MaxLen characters from Source to Dest, and makes Dest a null terminated string. No length checking is performed. Length of a null-terminated string. Returns the length of the null-terminated string P. None. Compare limited number of characters in 2 null-terminated strings, ignoring case.

Compares maximum L characters of the null-terminated strings S1 and S2, ignoring case. The result is

  • A negative Longint when S1<S2.
  • 0 when S1=S2.
  • A positive Longint when S1>S2.

For an example, see

None. Convert null-terminated string to all-lowercase. Converts P to an all-lowercase string. Returns P. None. Move a null-terminated string to new location. Copies MaxLen characters from Source to Dest. No terminating null-character is copied. Returns Dest None. Allocate room for new null-terminated string. Copies P to the Heap, and returns a pointer to the copy. Returns Nil if no memory was available for the copy. Convert a null-terminated string to a shortstring. Converts a null terminated string in P to a Pascal string, and returns this string. The string is truncated at 255 characters. None. Copy a pascal string to a null-terminated string Converts the Pascal string in Source to a Null-terminated string, and copies it to Dest. Dest needs enough room to contain the string Source, i.e. Length(Source)+1 bytes. No length checking is performed. Search for a null-terminated substring in a null-terminated string Returns a pointer to the first occurrence of S2 in S1. If S2 does not occur in S1, returns Nil. None. Find last occurrence of a character in a null-terminated string.

Returns a pointer to the last occurrence of the character C in the null-terminated string P. If C does not occur, returns Nil.

For an example, see .

None. Find first occurrence of a character in a null-terminated string. Returns a pointer to the first occurrence of the character C in the null-terminated string P. If C does not occur, returns Nil. None. Convert null-terminated string to all-uppercase

Converts P to an all-uppercase string. Returns P.

For an example, see

None.