Difference between revisions of "LlFloor"

From Second Life Wiki
Jump to navigation Jump to search
m
 
(13 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{LSL_Function
{{LSL_Function
|func=llFloor
|func=llFloor
|sort=Floor
|func_id=9|func_sleep=0.0|func_energy=10.0
|func_id=9
|func_sleep=0.0
|func_energy=10.0
|func_footnote
|func_footnote
|p1_type=float|p1_name=val|p1_desc=Any valid float value
|p1_type=float|p1_name=val|p1_desc=Any valid float value
|return_type=float
|return_type=integer
|return_text=that is the integer value of '''val''' rounded towards negative infinity (return <= '''val''').
|return_text=that is the integer value of {{LSLP|val}} rounded towards negative infinity <code>(return <= {{LSLPT|val}})</code>.
|spec
|spec
|caveats
|caveats=
|examples=<pre>
* The returned value is -2147483648 (0x80000000) if the arithmetic result is outside of the range of valid integers (-2147483648 to 2147483647 inclusive).
default {
|examples=<source lang="lsl2">default
{
   state_entry()
   state_entry()
   {
   {
       llSay(0,"The floor value of -4.5 is: "+(string)llFloor(-4.5) );
       llSay(0, "The floor value of -4.5 is: "+(string)llFloor(-4.5) );
  }
      //Returns "The floor value of -4.5 is: -5"
}
 
</pre>
      llSay(0,  "The floor value of -4.9 is: "+(string)llFloor(-4.9) );
      //Returns "The floor value of -4.9 is: -5"
 
      llSay(0,  "The floor value of -4.1 is: "+(string)llFloor(-4.1) );
      //Returns "The floor value of -4.1 is: -5"
 
      llSay(0,  "The floor value of 4.5 is: "+(string)llFloor(4.5) );
      //Returns "The floor value of 4.5 is: 4"
 
      llSay(0,  "The floor value of 4.9 is: "+(string)llFloor(4.9) );
      //Returns "The floor value of 4.9 is: 4"
 
      llSay(0,  "The floor value of 4.1 is: "+(string)llFloor(4.1) );
      //Returns "The floor value of 4.1 is: 4"
    }
}</source>
|helpers
|helpers
|constants
|constants
Line 24: Line 37:
|also_events
|also_events
|also_articles
|also_articles
|also_functions={{{!}}
|also_functions={{LSL DefineRow||[[llRound]]|Rounds the float to an integer towards the closest integer}}
{{LSL DefineRow||[[llRound]]|Rounds the float to an integer towards the closest integer}}
{{LSL DefineRow||[[llCeil]]|Rounds the float to an integer towards positive infinity}}
{{LSL DefineRow||[[llCeil]]|Rounds the float to an integer towards positive infinity}}
{{!}}}
|notes=*For positive values, it is quicker and shorter to simply cast the float to an integer. i=(integer)f is 32 bytes shorter than i=llFloor(f) (in Byte Code) and about 30 times faster in execution, while giving the same result.
|notes
|cat1=Math
|cat1=Math
|cat2
|cat2

Latest revision as of 00:24, 22 January 2015

Summary

Function: integer llFloor( float val );
0.0 Forced Delay
10.0 Energy

Returns an integer that is the integer value of val rounded towards negative infinity (return <= val).

• float val Any valid float value

Caveats

  • The returned value is -2147483648 (0x80000000) if the arithmetic result is outside of the range of valid integers (-2147483648 to 2147483647 inclusive).

Examples

default
{
   state_entry()
   {
       llSay(0,  "The floor value of -4.5 is: "+(string)llFloor(-4.5) );
       //Returns "The floor value of -4.5 is: -5"

       llSay(0,  "The floor value of -4.9 is: "+(string)llFloor(-4.9) );
       //Returns "The floor value of -4.9 is: -5"

       llSay(0,  "The floor value of -4.1 is: "+(string)llFloor(-4.1) );
       //Returns "The floor value of -4.1 is: -5"

       llSay(0,  "The floor value of 4.5 is: "+(string)llFloor(4.5) );
       //Returns "The floor value of 4.5 is: 4"

       llSay(0,  "The floor value of 4.9 is: "+(string)llFloor(4.9) );
       //Returns "The floor value of 4.9 is: 4"

       llSay(0,  "The floor value of 4.1 is: "+(string)llFloor(4.1) );
       //Returns "The floor value of 4.1 is: 4"
    }
}

Notes

  • For positive values, it is quicker and shorter to simply cast the float to an integer. i=(integer)f is 32 bytes shorter than i=llFloor(f) (in Byte Code) and about 30 times faster in execution, while giving the same result.

See Also

Functions

•  llRound Rounds the float to an integer towards the closest integer
•  llCeil Rounds the float to an integer towards positive infinity

Deep Notes

Signature

function integer llFloor( float val );