LSL 101/String Concatenation

← Strings and Simple Output

↑̲  LSL 101  ̲↑

Integers →

---

LSL 101: The Wikibook

• A Gentle Introduction
• The Structure of a Script
  • Simple Script Skeleton
  • Comments, White-space and Formatting
• Events & Event Handlers
  • The touch start Event
• Variables
  • Strings and Simple Output
    • String Concatenation
  • Integers
  • Using Variables
    • Global vs Local Variables
    • Variable Initialization
• Functions
  • Functions That Return a Value

The End Game

• Creating a Script
• Compile Time Errors
• Logic
• Conclusion

String concatenation allows us to combine two or more strings into a single string, as if they were simply pasted together. Here's an example where we use string concatenation to put the region name into a complete sentence.

default
{
     state_entry()
     {
          // Let the object's owner know the script is working
          llOwnerSay( "Congratulations! Your script has started to execute." );
     }
 
     touch_start( integer num_detected )
     {
          // Announce the region where the script is running
          llOwnerSay( "Welcome to " + llGetRegionName() + "." );
     }
}

The + sign, when used with strings, indicates concatenation. This is analogous to the use of + with integers to denote integer addition.

As in the previous example, the server executes llGetRegionName and reduces the line to the equivalent of

    llOwnerSay( "Welcome to " + "Ganymede" + "." );

It then concatenates the three strings, so it is equivalent to

    llOwnerSay( "Welcome to Ganymede." );

You might be thinking that an alternative to using string concatenation could be

    llOwnerSay( "Welcome to ", llGetRegionName(), "." );

But this won't work, because llOwnerSay expects only one string. Another alternative,

    llOwnerSay( "Welcome to ");
    llOwnerSay( llGetRegionName() );
    llOwnerSay( "." );

is legal, but it produces three separate lines of chat instead of one.

Even if everything you read here seems completely clear, your understanding will be much better if you actually write scripts as you go along. So here's a suggested exercise. The built-in function llGetDate returns a string representing today's date. Write and test a script that announces the date whenever it is clicked on.

Proceed onward to Integers or go back to Strings and Simple Output.