Difference between revisions of "Left"

From Second Life Wiki
Jump to: navigation, search
m (added to Category:LSL String)
(Undo revision 1142069 by Opensource Obscure (Talk) + string)
Line 1: Line 1:
{{LSL Header}} __NOTOC__
+
{{LSL_Function
<div id="box">
+
|mode=user
== Function: [[string]] left([[float]] {{LSL Param|num}}, [[integer]] {{LSL Param|places}} , [[string]] {{LSL Param|rnd}}); ==
+
|func=left
<div style="padding: 0.5em;">
+
|p1_type=string|p1_name=src
Returns text left of a specified separator
+
|p2_type=string|p2_name=divider
 +
|return_type=string
 +
|return_text=that is the text in '''src''' that is left of the first occurrence of '''divider'''.  
 +
|func_desc=Returns text left of a specified separator
 +
|func_footnote=
 +
If '''divider''' is not found then '''src''' is returned in it's entirety.
  
 
See also: [[Right]]
 
See also: [[Right]]
 
+
|examples=
Example:<br />
+
<lsl>string value = left("Colour=Brown", "="); //value == "Colour"</lsl>
 
+
|spec=<lsl>string left(string src, string divider) {
string notecardparameter = left(sdata,"=");
+
    integer index = llSubStringIndex( src, divider );
//in a notecard line that reads Colour=Brown, returns "Colour="
+
    if(~index)
 
+
        return llDeleteSubString( src, index, -1);
 
+
    return src;
</div></div>
+
}</lsl>
<div id="box">
+
|helpers
== Specification ==
+
|also_functions
<div style="padding: 0.5em;">
+
|also_events
<lsl>
+
|also_tests
string left (string src, string divider) {
+
|also_articles
      integer iStart = llSubStringIndex( src, divider ) + 1;  
+
|location
      string result = llGetSubString( src, 0, iStart -1) ;//note -2 here if you don't want the divider included in what you get back
+
|notes
      return result;
+
|cat1=Examples
}
+
|cat2=String
</lsl>
+
|cat3
</div></div>
+
|cat4
 
+
}}
Inspired by (and evolved from) discussions between Cheree Bury & Domino Marama in the SL Scripting Forum July 2008 at http://forums.secondlife.com/showthread.php?t=267884, with optional rounding added (that part being inspired by work by various authors here: https://wiki.secondlife.com/wiki/Fixed_Precision )
+
 
+
{{LSLC|Examples|left}}
+
[[Category:LSL String]]
+

Revision as of 10:41, 2 May 2011

Summary

Function: string left( string src, string divider );

Returns text left of a specified separator
Returns a string that is the text in src that is left of the first occurrence of divider.

• string src
• string divider

If divider is not found then src is returned in it's entirety.

See also: Right

Specification

<lsl>string left(string src, string divider) {

   integer index = llSubStringIndex( src, divider );
   if(~index)
       return llDeleteSubString( src, index, -1);
   return src;

}</lsl>

Examples

<lsl>string value = left("Colour=Brown", "="); //value == "Colour"</lsl>