Minoca-os/lib/rtl/base/string.c

/*++

Copyright (c) 2012 Minoca Corp. All Rights Reserved

Module Name:

    string.c

Abstract:

    This module implements common string manipulation functions used by the
    kernel.

Author:

    Evan Green 24-Jul-2012

Environment:

    Kernel

--*/

//
// ------------------------------------------------------------------- Includes
//

#include "rtlp.h"

//
// ---------------------------------------------------------------- Definitions
//

//
// ----------------------------------------------- Internal Function Prototypes
//

//
// ------------------------------------------------------ Data Type Definitions
//

//
// -------------------------------------------------------------------- Globals
//

//
// ------------------------------------------------------------------ Functions
//

RTL_API
ULONG
RtlStringCopy (
    PSTR Destination,
    PSTR Source,
    ULONG BufferSize
    )

/*++

Routine Description:

    This routine copies a string from one buffer to another, including the NULL
    terminator.

Arguments:

    Destination - Supplies a pointer to the buffer where the string will be
        copied to.

    Source - Supplies a pointer to the string to copy.

    BufferSize - Supplies the size of the destination buffer.

Return Value:

    Returns the number of bytes copied, including the NULL terminator. If the
    source string is longer than the destination buffer, the string will be
    truncated but still NULL terminated.

--*/

{

    ULONG ByteIndex;

    ASSERT(BufferSize != 0);

    for (ByteIndex = 0; ByteIndex < BufferSize; ByteIndex += 1) {
        Destination[ByteIndex] = Source[ByteIndex];
        if (Source[ByteIndex] == STRING_TERMINATOR) {
            break;
        }
    }

    if (ByteIndex == BufferSize) {
        ByteIndex -= 1;
    }

    //
    // Terminate the string in case the source was too long.
    //

    Destination[ByteIndex] = STRING_TERMINATOR;
    return ByteIndex + 1;
}

RTL_API
VOID
RtlStringReverse (
    PSTR String,
    PSTR StringEnd
    )

/*++

Routine Description:

    This routine reverses the contents of a string. For example, the string
    "abcd" would get reversed to "dcba".

Arguments:

    String - Supplies a pointer to the beginning of the string to reverse.

    StringEnd - Supplies a pointer to one beyond the end of the string. That is,
        this pointer points to the first byte *not* in the string.

Return Value:

    None.

--*/

{

    ULONG Length;
    ULONG Position;
    UCHAR SwapSpace;

    Length = StringEnd - String;

    //
    // Work from the left towards the middle, swapping characters with their
    // positions on the other extreme. The truncation of Length / 2 is okay
    // because odd length strings do not need their middle byte swapped.
    //

    for (Position = 0; Position < (Length / 2); Position += 1) {
        SwapSpace = String[Position];
        String[Position] = String[Length - Position - 1];
        String[Length - Position - 1] = SwapSpace;
    }

    return;
}

RTL_API
ULONG
RtlStringLength (
    PSTR String
    )

/*++

Routine Description:

    This routine determines the length of the given string, not including its
    NULL terminator.

Arguments:

    String - Supplies a pointer to the beginning of the string.

Return Value:

    Returns the length of the string, not including the NULL terminator.

--*/

{

    ULONG Length;

    Length = 0;
    while (*String != STRING_TERMINATOR) {
        Length += 1;
        String += 1;
    }

    return Length;
}

RTL_API
BOOL
RtlAreStringsEqual (
    PSTR String1,
    PSTR String2,
    ULONG MaxLength
    )

/*++

Routine Description:

    This routine determines if the contents of two strings are equal, up to a
    maximum number of characters.

Arguments:

    String1 - Supplies a pointer to the first string to compare.

    String2 - Supplies a pointer to the second string to compare.

    MaxLength - Supplies the minimum of either string's buffer size.

Return Value:

    TRUE if the strings are equal up to the maximum length.

    FALSE if the strings differ in some way.

--*/

{

    if (String1 == String2) {
        return TRUE;
    }

    while ((*String1 != STRING_TERMINATOR) &&
           (*String2 != STRING_TERMINATOR) &&
           (MaxLength != 0)) {

        if (*String1 != *String2) {
            return FALSE;
        }

        String1 += 1;
        String2 += 1;
        MaxLength -= 1;
    }

    if ((MaxLength != 0) && (*String1 != *String2)) {
        return FALSE;
    }

    return TRUE;
}

RTL_API
BOOL
RtlAreStringsEqualIgnoringCase (
    PSTR String1,
    PSTR String2,
    ULONG MaxLength
    )

/*++

Routine Description:

    This routine determines if the contents of two strings are equal, up to a
    maximum number of characters. This routine is case insensitive.

Arguments:

    String1 - Supplies a pointer to the first string to compare.

    String2 - Supplies a pointer to the second string to compare.

    MaxLength - Supplies the minimum of either string's buffer size.

Return Value:

    TRUE if the strings are equal up to the maximum length.

    FALSE if the strings differ in some way.

--*/

{

    CHAR Character1;
    CHAR Character2;

    if (String1 == String2) {
        return TRUE;
    }

    while ((*String1 != STRING_TERMINATOR) &&
           (*String2 != STRING_TERMINATOR) &&
           (MaxLength != 0)) {

        Character1 = *String1;
        Character2 = *String2;
        if ((Character1 >= 'a') && (Character1 <= 'z')) {
            Character1 = Character1 - 'a' + 'A';
        }

        if ((Character2 >= 'a') && (Character2 <= 'z')) {
            Character2 = Character2 - 'a' + 'A';
        }

        if (Character1 != Character2) {
            return FALSE;
        }

        String1 += 1;
        String2 += 1;
        MaxLength -= 1;
    }

    if ((MaxLength != 0) && (*String1 != *String2)) {
        return FALSE;
    }

    return TRUE;
}

RTL_API
PSTR
RtlStringFindCharacter (
    PSTR String,
    CHAR Character,
    ULONG StringLength
    )

/*++

Routine Description:

    This routine searches a string for the first instance of the given
    character, scanning from the left.

Arguments:

    String - Supplies a pointer to the string to search.

    Character - Supplies a pointer to the character to search for within the
        string.

    StringLength - Supplies the length of the string, in bytes, including the
        NULL terminator.

Return Value:

    Returns a pointer to the first instance of the character on success.

    NULL if the character could not be found in the string.

--*/

{

    //
    // Search the string for the character as long as the end of the string
    // is not reached according to a NULL terminator or the string length.
    //

    while ((StringLength != 0) && (*String != STRING_TERMINATOR)) {
        if (*String == Character) {
            return String;
        }

        String += 1;
        StringLength -= 1;
    }

    return NULL;
}

RTL_API
PSTR
RtlStringFindCharacterRight (
    PSTR String,
    CHAR Character,
    ULONG StringLength
    )

/*++

Routine Description:

    This routine searches a string for the first instance of the given
    character, scanning from the right backwards. The function will search
    starting at the NULL terminator or string length, whichever comes first.

Arguments:

    String - Supplies a pointer to the string to search.

    Character - Supplies a pointer to the character to search for within the
        string.

    StringLength - Supplies the length of the string, in bytes, including the
        NULL terminator.

Return Value:

    Returns a pointer to the first instance of the character on success.

    NULL if the character could not be found in the string.

--*/

{

    PSTR Current;

    if ((String == NULL) || (StringLength == 0)) {
        return NULL;
    }

    //
    // Find the end of the string.
    //

    Current = String;
    while ((*Current != STRING_TERMINATOR) &&
           ((UINTN)Current - (UINTN)String < StringLength)) {

        Current += 1;
    }

    //
    // Now walk backwards looking for the character.
    //

    while (Current != String) {
        if (*Current == Character) {
            return Current;
        }

        Current -= 1;
    }

    if (*Current == Character) {
        return String;
    }

    return NULL;
}

RTL_API
PSTR
RtlStringSearch (
    PSTR InputString,
    UINTN InputStringLength,
    PSTR QueryString,
    UINTN QueryStringLength
    )

/*++

Routine Description:

    This routine searches a string for the first instance of the given string
    within it.

Arguments:

    InputString - Supplies a pointer to the string to search.

    InputStringLength - Supplies the length of the string, in bytes, including
        the NULL terminator.

    QueryString - Supplies a pointer to the null terminated string to search
        for.

    QueryStringLength - Supplies the length of the query string in bytes
        including the null terminator.

Return Value:

    Returns a pointer to the first instance of the string on success.

    NULL if the character could not be found in the string.

--*/

{

    size_t BadCharacterShift[MAX_UCHAR + 1];
    int Character;
    size_t LastIndex;
    size_t ScanIndex;

    if ((QueryString == NULL) || (InputString == NULL)) {
        return NULL;
    }

    if (QueryStringLength <= 1) {
        return (char *)InputString;
    }

    if (InputStringLength < QueryStringLength) {
        return NULL;
    }

    InputStringLength -= 1;
    QueryStringLength -= 1;

    //
    // Initialize the bad shift table assuming that no character exists in the
    // query string, and thus the search can be advanced by the entire query
    // string.
    //

    for (ScanIndex = 0; ScanIndex <= MAX_UCHAR; ScanIndex += 1) {
        BadCharacterShift[ScanIndex] = QueryStringLength;
    }

    //
    // Now find the last occurrence of each character and save it in the shift
    // table.
    //

    LastIndex = QueryStringLength - 1;
    for (ScanIndex = 0; ScanIndex < LastIndex; ScanIndex += 1) {
        Character = (UCHAR)(QueryString[ScanIndex]);
        BadCharacterShift[Character] = LastIndex - ScanIndex;
    }

    //
    // Search the query string.
    //

    while (InputStringLength >= QueryStringLength) {

        //
        // Scan from the end.
        //

        ScanIndex = LastIndex;
        while (InputString[ScanIndex] == QueryString[ScanIndex]) {
            if (ScanIndex == 0) {
                return (PSTR)InputString;
            }

            ScanIndex -= 1;
        }

        //
        // Move on to a new position. Skip based on the last character of the
        // input no matter where the mismatch is.
        //

        Character = (UCHAR)(InputString[LastIndex]);
        InputStringLength -= BadCharacterShift[Character];
        InputString += BadCharacterShift[Character];
    }

    return NULL;
}

//
// --------------------------------------------------------- Internal Functions
//