Class: Sass::Script::Number

Inherits:
Literal show all
Defined in:
/var/www/haml-pages/.haml/lib/sass/script/number.rb

Overview

A SassScript object representing a number. SassScript numbers can have decimal values, and can also have units. For example, 12, 1px, and 10.45em are all valid values.

Numbers can also have more complex units, such as 1px*em/in. These cannot be inputted directly in Sass code at the moment.

Constant Summary

PRECISION = The precision with which numbers will be printed to CSS files. 
1000.0

Instance Attribute Summary

Instance Method Summary

Methods inherited from Literal

#==, #_perform, #and, #assert_int!, #children, #comma, #concat, #neq, #options, #or, #single_eq, #to_bool, #unary_div, #unary_not

Methods inherited from Node

#_perform, #children, #dasherize, #perform

Constructor Details

- (Number) initialize(value, numerator_units = [], denominator_units = [])

A new instance of Number

Parameters:



47
48
49
50
51
52
 
# File '/var/www/haml-pages/.haml/lib/sass/script/number.rb', line 47

def initialize(value, numerator_units = [], denominator_units = [])
  super(value)
  @numerator_units = numerator_units
  @denominator_units = denominator_units
  normalize!
end

Instance Attribute Details

- (Array<String>) denominator_units (readonly)

A list of units in the denominator of the number. For example, 1px*em/in*cm would return ["in", "cm"]

Returns:



26
27
28
 
# File '/var/www/haml-pages/.haml/lib/sass/script/number.rb', line 26

def denominator_units
  @denominator_units
end

- (Array<String>) numerator_units (readonly)

A list of units in the numerator of the number. For example, 1px*em/in*cm would return ["px", "em"]

Returns:



21
22
23
 
# File '/var/www/haml-pages/.haml/lib/sass/script/number.rb', line 21

def numerator_units
  @numerator_units
end

- (Boolean?) original

The original representation of this number. For example, although the result of 1px/2px is 0.5, the value of #original is "1px/2px".

This is only non-nil when the original value should be used as the CSS value, as in font: 1px/2px.

Returns:

  • (Boolean, nil) 


36
37
38
 
# File '/var/www/haml-pages/.haml/lib/sass/script/number.rb', line 36

def original
  @original
end

- (Numeric) value (readonly)

The Ruby value of the number.

Returns:

  • (Numeric) 


16
17
18
 
# File '/var/www/haml-pages/.haml/lib/sass/script/number.rb', line 16

def value
  @value
end

Instance Method Details

- (Number) coerce(num_units, den_units)

Returns this number converted to other units. The conversion takes into account the relationship between e.g. mm and cm, as well as between e.g. in and cm.

If this number has no units, it will simply return itself with the given units.

An incompatible coercion, e.g. between px and cm, will raise an error.

Parameters:

Returns:

  • (Number) — The number with the new units

Raises:



302
303
304
305
306
307
308
309
 
# File '/var/www/haml-pages/.haml/lib/sass/script/number.rb', line 302

def coerce(num_units, den_units)
  Number.new(if unitless?
               self.value
             else
               self.value * coercion_factor(self.numerator_units, num_units) /
                 coercion_factor(self.denominator_units, den_units)
             end, num_units, den_units)
end

- (Boolean) comparable_to?(other)

Whether or not this number can be compared with the other.

Parameters:

  • (Number) other — A number to decide if it can be compared with this number.

Returns:

  • (Boolean) — Whether or not this number can be compared with the other. 


313
314
315
316
317
318
319
320
 
# File '/var/www/haml-pages/.haml/lib/sass/script/number.rb', line 313

def comparable_to?(other)
  begin
    operate(other, :+)
    true
  rescue Sass::UnitConversionError
    false
  end
end

- (Literal) div(other)

The SassScript / operation. Its functionality depends on the type of its argument:

Number
Divides this number by the other, converting units appropriately.
Literal
See Literal#div.

Parameters:

  • (Literal) other — The right-hand side of the operator

Returns:

  • (Literal) — The result of the operation 


146
147
148
149
150
151
152
153
154
155
156
 
# File '/var/www/haml-pages/.haml/lib/sass/script/number.rb', line 146

def div(other)
  if other.is_a? Number
    res = operate(other, :/)
    if self.original && other.original && context != :equals
      res.original = "#{self.original}/#{other.original}"
    end
    res
  else
    super
  end
end

- (Boolean) eq(other)

The SassScript == operation.

Parameters:

  • (Literal) other — The right-hand side of the operator

Returns:

  • (Boolean) — Whether this number is equal to the other object 


179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
 
# File '/var/www/haml-pages/.haml/lib/sass/script/number.rb', line 179

def eq(other)
  return Sass::Script::Bool.new(false) unless other.is_a?(Sass::Script::Number)
  this = self
  begin
    if unitless?
      this = this.coerce(other.numerator_units, other.denominator_units)
    else
      other = other.coerce(numerator_units, denominator_units)
    end
  rescue Sass::UnitConversionError
    return Sass::Script::Bool.new(false)
  end

  Sass::Script::Bool.new(this.value == other.value)
end

- (Boolean) gt(other)

The SassScript > operation.

Parameters:

  • (Number) other — The right-hand side of the operator

Returns:

  • (Boolean) — Whether this number is greater than the other

Raises:

  • (NoMethodError) — if other is an invalid type 


200
201
202
203
 
# File '/var/www/haml-pages/.haml/lib/sass/script/number.rb', line 200

def gt(other)
  raise NoMethodError.new(nil, :gt) unless other.is_a?(Number)
  operate(other, :>)
end

- (Boolean) gte(other)

The SassScript >= operation.

Parameters:

  • (Number) other — The right-hand side of the operator

Returns:

  • (Boolean) — Whether this number is greater than or equal to the other

Raises:

  • (NoMethodError) — if other is an invalid type 


210
211
212
213
 
# File '/var/www/haml-pages/.haml/lib/sass/script/number.rb', line 210

def gte(other)
  raise NoMethodError.new(nil, :gte) unless other.is_a?(Number)
  operate(other, :>=)
end

- (String) inspect(opts = {}) Also known as: to_sass

Returns a readable representation of this number.

This representation is valid CSS (and valid SassScript) as long as there is only one unit.

Returns:

  • (String) — The representation 


250
251
252
253
254
255
256
257
258
259
260
 
# File '/var/www/haml-pages/.haml/lib/sass/script/number.rb', line 250

def inspect(opts = {})
  value =
    if self.value.is_a?(Float) && (self.value.infinite? || self.value.nan?)
      self.value
    elsif int?
      self.value.to_i
    else
      (self.value * PRECISION).round / PRECISION
    end
  "#{value}#{unit_str}"
end

- (Boolean) int?

Whether or not this number is an integer.

Returns:

  • (Boolean) — Whether or not this number is an integer. 


271
272
273
 
# File '/var/www/haml-pages/.haml/lib/sass/script/number.rb', line 271

def int?
  value % 1 == 0.0
end

- (Boolean) legal_units?

Whether or not this number has units that can be represented in CSS (that is, zero or one #numerator_units).

Returns:

  • (Boolean) — Whether or not this number has units that can be represented in CSS (that is, zero or one #numerator_units). 


282
283
284
 
# File '/var/www/haml-pages/.haml/lib/sass/script/number.rb', line 282

def legal_units?
  (numerator_units.empty? || numerator_units.size == 1) && denominator_units.empty?
end

- (Boolean) lt(other)

The SassScript < operation.

Parameters:

  • (Number) other — The right-hand side of the operator

Returns:

  • (Boolean) — Whether this number is less than the other

Raises:

  • (NoMethodError) — if other is an invalid type 


220
221
222
223
 
# File '/var/www/haml-pages/.haml/lib/sass/script/number.rb', line 220

def lt(other)
  raise NoMethodError.new(nil, :lt) unless other.is_a?(Number)
  operate(other, :<)
end

- (Boolean) lte(other)

The SassScript <= operation.

Parameters:

  • (Number) other — The right-hand side of the operator

Returns:

  • (Boolean) — Whether this number is less than or equal to the other

Raises:

  • (NoMethodError) — if other is an invalid type 


230
231
232
233
 
# File '/var/www/haml-pages/.haml/lib/sass/script/number.rb', line 230

def lte(other)
  raise NoMethodError.new(nil, :lte) unless other.is_a?(Number)
  operate(other, :<=)
end

- (Literal) minus(other)

The SassScript binary - operation (e.g. $a - $b). Its functionality depends on the type of its argument:

Number
Subtracts this number from the other, converting units if possible.
Literal
See Literal#minus.

Parameters:

  • (Literal) other — The right-hand side of the operator

Returns:

  • (Literal) — The result of the operation

Raises:



91
92
93
94
95
96
97
 
# File '/var/www/haml-pages/.haml/lib/sass/script/number.rb', line 91

def minus(other)
  if other.is_a? Number
    operate(other, :-)
  else
    super
  end
end

- (Number) mod(other)

The SassScript % operation.

Parameters:

  • (Number) other — The right-hand side of the operator

Returns:

  • (Number) — This number modulo the other

Raises:



164
165
166
167
168
169
170
171
172
173
 
# File '/var/www/haml-pages/.haml/lib/sass/script/number.rb', line 164

def mod(other)
  if other.is_a?(Number)
    unless other.unitless?
      raise Sass::UnitConversionError.new("Cannot modulo by a number with units: #{other.inspect}.")
    end
    operate(other, :%)
  else
    raise NoMethodError.new(nil, :mod)
  end
end

- (Literal) plus(other)

The SassScript + operation. Its functionality depends on the type of its argument:

Number
Adds the two numbers together, converting units if possible.
Color
Adds this number to each of the RGB color channels.
Literal
See Literal#plus.

Parameters:

  • (Literal) other — The right-hand side of the operator

Returns:

  • (Literal) — The result of the operation

Raises:



69
70
71
72
73
74
75
76
77
 
# File '/var/www/haml-pages/.haml/lib/sass/script/number.rb', line 69

def plus(other)
  if other.is_a? Number
    operate(other, :+)
  elsif other.is_a?(Color)
    other.plus(self)
  else
    super
  end
end

- (Number, Color) times(other)

The SassScript * operation. Its functionality depends on the type of its argument:

Number
Multiplies the two numbers together, converting units appropriately.
Color
Multiplies each of the RGB color channels by this number.

Parameters:

  • (Number, Color) other — The right-hand side of the operator

Returns:

Raises:

  • (NoMethodError) — if other is an invalid type 


125
126
127
128
129
130
131
132
133
 
# File '/var/www/haml-pages/.haml/lib/sass/script/number.rb', line 125

def times(other)
  if other.is_a? Number
    operate(other, :*)
  elsif other.is_a? Color
    other.times(self)
  else
    raise NoMethodError.new(nil, :times)
  end
end

- (Fixnum) to_i

The integer value of the number

Returns:

  • (Fixnum) — The integer value of the number

Raises:



265
266
267
268
 
# File '/var/www/haml-pages/.haml/lib/sass/script/number.rb', line 265

def to_i
  super unless int?
  return value
end

- (String) to_s

The CSS representation of this number

Returns:

  • (String) — The CSS representation of this number

Raises:

  • (Sass::SyntaxError) — if this number has units that can’t be used in CSS (e.g. px*in) 


238
239
240
241
242
 
# File '/var/www/haml-pages/.haml/lib/sass/script/number.rb', line 238

def to_s
  return original if original
  raise Sass::SyntaxError.new("#{inspect} isn't a valid CSS value.") unless legal_units?
  inspect
end

- (Number) unary_minus

The SassScript unary - operation (e.g. -$a).

Returns:

  • (Number) — The negative value of this number 


109
110
111
 
# File '/var/www/haml-pages/.haml/lib/sass/script/number.rb', line 109

def unary_minus
  Number.new(-value, numerator_units, denominator_units)
end

- (Number) unary_plus

The SassScript unary + operation (e.g. +$a).

Returns:

  • (Number) — The value of this number 


102
103
104
 
# File '/var/www/haml-pages/.haml/lib/sass/script/number.rb', line 102

def unary_plus
  self
end

- (String) unit_str

Returns a human readable representation of the units in this number. For complex units this takes the form of: numerator_unit1 * numerator_unit2 / denominator_unit1 * denominator_unit2

Returns:

  • (String) — a string that represents the units in this number 


326
327
328
329
330
331
332
333
 
# File '/var/www/haml-pages/.haml/lib/sass/script/number.rb', line 326

def unit_str
  rv = numerator_units.sort.join("*")
  if denominator_units.any?
    rv << "/"
    rv << denominator_units.sort.join("*")
  end
  rv
end

- (Boolean) unitless?

Whether or not this number has no units.

Returns:

  • (Boolean) — Whether or not this number has no units. 


276
277
278
 
# File '/var/www/haml-pages/.haml/lib/sass/script/number.rb', line 276

def unitless?
  numerator_units.empty? && denominator_units.empty?
end