%stringGetModifiableIndexes()

Aliases%stringGetModifiableIndexes( )
Parametersstring @text

    This function will return an array containing all the indexes of characters
    in @text that can be modified such that colour tags and ANSI escape
    sequences are preserved. These indexes can then be used to modify the text
    in a safe way. For instance, the %stringSmokey() function uses the internal
    version of this function to make content look "smokey" by replacing
    modifiable characters with periods.

    Example:
    --------------------------------------------------------------------------

    %mobSendBufferOpen( @actor )
    %do( @actor, "look" )
    @buffer = %mobSendBufferGetContents( @actor )
    %mobSendBufferClose( @actor )

    @indexes = %stringGetModifiableIndexes( @buffer )
    @indexes = %arrayShuffle( @indexes )

    // 30% character replacement.
    @maxChars = (%arrayGetSize( @indexes ) * 30) / 100;

    for( @i = 0; @i < @maxChars; @i += 1 )
    {
        if( @buffer->(@indexes->@i) != "\n"
        \   &&
        \   @buffer->(@indexes->@i) != ' ' )
        {
            @buffer->(@indexes->@i) = '.';
        }
        endif
    }
    endfor

    %echoTo( @buffer, @actor, allowSleeping, noFormat )

The Worlds of Carnage MUD is a non-profit, fantasy oriented, text-based game that is played over telnet. We are devoted to providing a social medium in which people can have fun while immersing themselves in a game that reads like a book. You can connect by clicking here or if that fails then here. This site is maintained and hosted by Robert Cummings, A.K.A Blobule. The Worlds of Carnage are often recognized via the following aliases: Carnage; WoC; WoC MUD; Carnage MUD; CarnageMUD; WoCMUD. All submissions become the property of Robert Cummings where the submitter holds copyright. If you do not want to give ownership, then do not submit.