SC2Mapster

RandString by Miles

Description

RandString is a simple function that returns a randomized string. This function can be used anywhere that strings can be used. There is almost no setting up required - all you have to do is import the library and start using the function.

• Great taste, low calories.

Okay, so you might be asking yourself, "Self, why would Miles go through all the trouble of making this silly library?" Well, Self, there may be a situation where you just have to have a random string and nothing else will do. Personally, I intend to use it to display gibberish on a dialog item to simulate data encryption or something like that. It will be awesome, trust me.

Demonstration

The simplest way to use this would be to set some string variable. Let's call it String_X.

        Variable - Set String_X = (RandString(5, True, True, True, True, "", ""))

This example will set String_X to a random, 5-character string. It could include such wonderful strings as:

• jH4S%
• i $%4
• 00000 (it could happen)
• {4Gs5

And so on. You can also set it to exclude or include letters, numbers, symbols, and/or spaces. Furthermore, you can set it to concatenate an initial substring or end substring. For example:

                              "HERES MAH STRING: g5*7& <--- WASNT THAT AWESOME?!"

I should note that Initial String and End String are not considered when setting Length.

Installation

All you have to do is download the library to a folder of your choice, then import it into the trigger editor and place wherever you like. Then you just call the RandString function wherever you can put a string.

Download

See the attachment on this thread.

README

Here's the official README as it's included in the library:

README

RandString

Created by BasharTeg6 (Miles)

TERMS OF USE:

By using this library, you agree to the following terms of use:
- You (the User) will credit Miles (the Author) for the use of RandString (this library) even if you make modifications.
- You will share your modifications with the Author so he can update the library if necessary (please)

PURPOSE:

RandString is a simple function that returns a randomized string. This function can be used anywhere that strings can be used.

PARAMETERS:

There are several options you can set when using the function. Here is a breakdown:

Length: Sets the total length of the string. A length of 0 or less (negative numbers) will only return the Initial String and End String. 
There is no maximum, although any value you put here will be constrained by the StarCraft II engine.

Include Letters?/Numbers?/Symbols?/Spaces?: Do I really need to explain what these do? At any rate, setting all of these to FALSE has the
same effect as setting Length to 0 or negative.

Initial String: Optional preceding string. The string returned from the function takes the form <Initial String><Randomized String><End String>.

End String: Optional following string. The string returned from the function takes the form <Initial String><Randomized String><End String>.