User:Fred Gandt/Scripts/Functions

My Contributions

I have implemented a V# system to make it more obvious if a function is updated. The V# forms part of the title of each function.

If you have any comments about the content of this page please post them HERE

All my scripting is written for compilation as MONO

More Pages

Free Scripts (content constantly updating)

More Free Scripts (content constantly updating)

Even More Free Scripts (content constantly updating)

Even More More Free Scripts (content constantly updating)

Even More More More Free Scripts (content constantly updating)

Functions for specific tasks (this page)

Legal Stuff

The legal stuff about contributing to this wiki. (worth reading)

PJIRA Issue Tracker

The issues I have filed on the PJIRA

Tuition

Tuition scripts, notes, videos and screenshots etc. (hardly any content yet)

Functions

A collection of functions that perform defined actions. Things we can't use one Linden Library function to do.

GetUniqueListEntries ( V1 )

Feed a list in and get out a list which contains no duplicate entries. Fast.

<lsl>// V1 //

list GetUniqueListEntries(list src) {

   integer index = 0;
   list output = [];
   list entry = [];
   do
   {
       output += (entry = llList2List(src, 0, 0));
       src = llDeleteSubList(src, 0, 0);
       while((index = llListFindList(src, entry)) != -1)
       src = llDeleteSubList(src, index, index);
   }
   while(llGetListLength(src));
   return output;

}

// Usage Example //

list source = ["How", "much", "wood", "would", "a", "woodchuck", "chuck", "if", "a", "woodchuck", "could", "chuck", "wood", "?"];

default {

   state_entry()
   {
       llOwnerSay(llDumpList2String(GetUniqueListEntries(source), ", "));
       // Return == "How, much, wood, would, a, woodchuck, chuck, if, could, ?"
   }

}</lsl>

MultiListReplace ( V1 )

Replace entries in a list with other entries.

<lsl>// V1 //

list MultiListReplace(list src, list thisnthats) {

   integer index = 0;
   integer lc = 0;
   integer ll = llGetListLength(thisnthats);
   do
   {
       list this = llList2List(thisnthats, lc, lc);
       ++lc;
       while((index = llListFindList(src, this)) != -1)
       src = llListReplaceList(src, llList2List(thisnthats, lc, lc), index, index);
   }
   while((++lc) < ll);
   return src;

}

// Usage Example //

list source = ["How", "much", "wood", "would", "a", "woodchuck", "chuck", "if", "a", "woodchuck", "could", "chuck", "wood", "?"];

default {

   state_entry()
   {
       llOwnerSay(llDumpList2String(MultiListReplace(source, ["woodchuck", "primrezzer", "much", "many", "wood", "prims", "chuck", "rez"]), ", "));
       // Return == "How, many, prims, would, a, primrezzer, rez, if, a, primrezzer, could, rez, prims, ?"
   }

}</lsl>

MultiStringReplace ( V4 )

Replace parts of a string with other strings.

<lsl>// V4 //

string MultiStringReplace(string src, list thisnthats) {

   integer index = 0;
   integer lc = -1;
   integer ll = llGetListLength(thisnthats);
   do
   {
       string this = llList2String(thisnthats, (++lc));
       while((index = llSubStringIndex(src, this)) != -1)
       src = llInsertString(llDeleteSubString(src, index, (index + (llStringLength(this) - 1))),
                            index, llList2String(thisnthats, lc));
   }
   while((++lc) < ll);
   return src;

}

// Usage Examples //

string source = "How much wood would a woodchuck chuck if a woodchuck could chuck wood?";

default {

   state_entry()
   {
       llOwnerSay(MultiStringReplace(source, ["woodchuck", "primrezzer", "much", "many", "wood", "prims", "chuck", "rez"]));
       // Return == "How many prims would a primrezzer rez if a primrezzer could rez prims?"
       
       llOwnerSay(MultiStringReplace(source, ["much", "many", "wood", "prims", "woodchuck", "primrezzer", "chuck", "rez"]));
       // Return == "How many prims would a primsrez rez if a primsrez could rez prims?"
       
       llOwnerSay(MultiStringReplace(source, ["farmers", "primrezzer", "much", "many", "wood", "prims", "chuck", "rez"]));
       // Return == "How many prims would a primsrez rez if a primsrez could rez prims?"
       
       llOwnerSay(MultiStringReplace(source, ["much", "many", "wood", "prims", "farmers", "primrezzer", "chuck", "rez"]));
       // Return == "How many prims would a primsrez rez if a primsrez could rez prims?"
       
       llOwnerSay(MultiStringReplace(source, ["woodchuck", "primrezzer", "much", "many", "wood", "prims", "farmers", "piggies", "chuck", "rez"]));
       // Return == "How many prims would a primrezzer rez if a primrezzer could rez prims?"
   }

}</lsl>

StrideOfList ( V2 )

Get strided entries from a list. And yes, I know about llList2ListStrided; Frankly, this works better.

<lsl>// V2 //

list StrideOfList(list src, integer stride, integer start, integer end) {

   list l = [];
   integer ll = llGetListLength(src);
   if(start < 0)start += ll;
   if(end < 0)end += ll;
   if(end < start) return llList2List(src, start, start);
   while(start <= end)
   {
       l += llList2List(src, start, start);
       start += stride;
   }
   return l;

}

// Usage Examples //

list source = ["How", "much", "wood", "would", "a", "woodchuck", "chuck", "if", "a", "woodchuck", "could", "chuck", "wood?"];

default {

   state_entry()
   {
       llOwnerSay(llDumpList2String(StrideOfList(source, 1, 0, -1), ", "));
       // Return == "How, much, wood, would, a, woodchuck, chuck, if, a, woodchuck, could, chuck, wood?"

       llOwnerSay(llDumpList2String(StrideOfList(source, 2, 0, -2), ", "));
       // Return == "How, wood, a, chuck, a, could"

       llOwnerSay(llDumpList2String(StrideOfList(source, 4, 3, -1), ", "));
       // Return == "would, if, chuck"

       llOwnerSay(llDumpList2String(StrideOfList(source, 5, 3, -4), ", "));
       // Return == "would, a"

       llOwnerSay(llDumpList2String(StrideOfList(source, 3, -10, -7), ", "));
       // Return == "would, chuck"

       llOwnerSay(llDumpList2String(StrideOfList(source, 3, 7, -7), ", ")); // Start index is closer to end that end index.
       // Return == "if"                                            // Start is returned only.
   }

}</lsl>

Capitalization Functions

ToNormal ( V4 )

Returns a string that holds true to a few simple rules.

• First person reference "I" is capitalized.
• Specified names are capitalized.
• The first word of each proper sentence is capitalized.

• This includes quotes. E.g. "Time is an illusion; Lunchtime, doubly so." - Douglas Adams
• Also new lines (see examples below).

I would imagine the results will be a mess if the source is not neatly written. I'll work on improving it as time goes on (it's a start).

<lsl>// V4 //

string ToNormal(string src, list names) {

   list abc = ["a","b","c","d","e","f","g","h","i","j","k","l","m", // The script needs to know what a letter is.
               "n","o","p","q","r","s","t","u","v","w","x","y","z"];
   list punc = [". ","; ","? ","! ", " \"","\n"]; // Punctuation we create a new sentance after.
   src = llToLower(" " + src + " ");
   string result = "";
   integer index = 0;
   integer lc = 0;
   integer ll = 0;
   string ko = "";
   if((ll = llGetListLength(names)))
   {
       do
       {
           string name = llToLower(llList2String(names, lc));
           while((index = llSubStringIndex(src, name)) != -1)
           src = llInsertString(llDeleteSubString(src, index, (index + (llStringLength(name) - 1))),
                                index, llList2String(names, lc));
       }
       while((++lc) < ll);
       index = 0;
   }
   while((index = llSubStringIndex(src, "i")) != -1)
   {
       if(ko == "")
       ko = llGetSubString(src, 0, (index - 1));
       if((llListFindList(abc, [llGetSubString(src, (index - 1), (index - 1))]) == -1)
       && (llListFindList(abc, [llGetSubString(src, (index + 1), (index + 1))]) == -1))
       {
           src = llDeleteSubString(src, index, index);
           result += ("I" + llGetSubString(src, index, (llSubStringIndex(src, "i") - 1)));
       }
       else
       {
           src = llDeleteSubString(src, index, index);
           result += ("i" + llGetSubString(src, index, (llSubStringIndex(src, "i") - 1)));
       }
   }
   names = llParseString2List(llStringTrim((result = (ko + result)), STRING_TRIM), [], punc); // Reusing variable to save bytes.
   lc = 0;
   index = -1;
   ll = llGetListLength(names);
   string ABC = llToUpper(llDumpList2String(abc, ""));
   do
   {
       string entry = llList2String(names, lc);
       do
       {
           ++index;
           result = llToUpper(llGetSubString(entry, index, index));
       }
       while(llSubStringIndex(ABC, result) == -1);
       names = llListReplaceList(names, [llInsertString(llDeleteSubString(entry, index, index), index, result)], lc, lc);
       index = -1;
   }
   while((++lc) < ll);
   return llDumpList2String(names, "");

}

// Usage Example //

//string source = "I can't help but wonder; \"What time should I and Sally arrive for dinner\"? For some reason, I like Tori Amos!! Should I?";

string source = "Confessions of a cigar smoker

I owe to smoking, more or less, Through life the whole of my success; With my Cigar I'm sage and wise - Without, I'm dull as cloudy skies. When smoking all my ideas soar, When not, they sink upon the floor. The greatest men have all been smokers, And so were all the greatest jokers. Then ye who'd bid adieu to care, Come here and smoke it into air.";

default {

   state_entry()
   {
       source = llToUpper(source); // For whatever reason...

       llOwnerSay(ToNormal(source, []));
       
       // OR (depending on source)
       
       //llOwnerSay(ToNormal(source, ["Sally", "Tori Amos"]));

// Return == "I can't help but wonder; "What time should I and Sally arrive for dinner"? For some reason, I like Tori Amos!! Should I?"

// OR (depending on source)

// Return == "Confessions of a cigar smoker

           //I owe to smoking, more or less,
           //Through life the whole of my success;
           //With my cigar I'm sage and wise -
           //Without, I'm dull as cloudy skies.
           //When smoking all my ideas soar,
           //When not, they sink upon the floor.
           //The greatest men have all been smokers,
           //And so were all the greatest jokers.
           //Then ye who'd bid adieu to care,
           //Come here and smoke it into air."
   }

}</lsl>

ToTitle ( V2 )

Returns a string with ALL first letters of ALL words capitalized. A slower (source length being equal) function than ToNormal but possibly more reliable.

<lsl>// V2 //

string ToTitle(string src) {

   list words = llParseString2List(llToLower(src), [], [".",";","?","!","\""," ","\n"]);
   integer ll = llGetListLength(words);
   integer lc = -1;
   string word = "";
   while((++lc) < ll)
   {
       string cap = llToUpper(llGetSubString((word = llList2String(words, lc)), 0, 0));
       words = llListReplaceList(words, [(cap + llDeleteSubString(word, 0, 0))], lc, lc);
   }
   return llDumpList2String(words, "");

}

// Usage Example //

string source = "I can't help but wonder; \"What time should I and Sally arrive for dinner\"? For some reason, I like Tori Amos!! Should I?";

//string source = "Confessions of a cigar smoker // //I owe to smoking, more or less, //Through life the whole of my success; //With my Cigar I'm sage and wise - //Without, I'm dull as cloudy skies. //When smoking all my ideas soar, //When not, they sink upon the floor. //The greatest men have all been smokers, //And so were all the greatest jokers. //Then ye who'd bid adieu to care, //Come here and smoke it into air.";

default {

   state_entry()
   {
       source = llToUpper(source); // For whatever reason...

       llOwnerSay(ToTitle(source));

// Return == "I Can't Help But Wonder; "What Time Should I And Sally Arrive For Dinner"? For Some Reason, I Like Tori Amos!! Should I?"

// OR (depending on source)

// Return == "Confessions Of A Cigar Smoker

           //I Owe To Smoking, More Or Less,
           //Through Life The Whole Of My Success;
           //With My Cigar I'm Sage And Wise -
           //Without, I'm Dull As Cloudy Skies.
           //When Smoking All My Ideas Soar,
           //When Not, They Sink Upon The Floor.
           //The Greatest Men Have All Been Smokers,
           //And So Were All The Greatest Jokers.
           //Then Ye Who'd Bid Adieu To Care,
           //Come Here And Smoke It Into Air."
   }

}</lsl>