Class: SassC::Script::Value::String

Inherits:
SassC::Script::Value show all
Defined in:
lib/sassc/script/value/string.rb

Instance Attribute Summary collapse

Attributes inherited from SassC::Script::Value

#options, #source_range

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from SassC::Script::Value

#==, #assert_int!, #bracketed, #eql?, #hash, #null?, #separator, #to_a, #to_bool, #to_h, #to_i, #with_contents

Constructor Details

#initialize(value, type = :identifier) ⇒ String

Creates a new string.

Parameters:

  • value (String) —

    See #value

  • type (Symbol) (defaults to: :identifier) —

    See #type

  • deprecated_interp_equivalent (String?) —

    If this was created via a potentially-deprecated string interpolation, this is the replacement expression that should be suggested to the user.



66
67
68
69
 
# File 'lib/sassc/script/value/string.rb', line 66

def initialize(value, type = :identifier)
  super(value)
  @type = type
end

Instance Attribute Details

#type ⇒ Symbol (readonly)

Whether this is a CSS string or a CSS identifier. The difference is that strings are written with double-quotes, while identifiers aren’t.

Returns:

  • (Symbol) —

    ‘:string` or `:identifier`



13
14
15
 
# File 'lib/sassc/script/value/string.rb', line 13

def type
  @type
end

#value ⇒ Object (readonly)

The Ruby value of the string.



6
7
8
 
# File 'lib/sassc/script/value/string.rb', line 6

def value
  @value
end

Class Method Details

.quote(contents, opts = {}) ⇒ Object

Returns the quoted string representation of ‘contents`.



22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
 
# File 'lib/sassc/script/value/string.rb', line 22

def self.quote(contents, opts = {})
  quote = opts[:quote]

  # Short-circuit if there are no characters that need quoting.
  unless contents =~ /[\n\\"']|\#\{/
    quote ||= '"'
    return "#{quote}#{contents}#{quote}"
  end

  if quote.nil?
    if contents.include?('"')
      if contents.include?("'")
        quote = '"'
      else
        quote = "'"
      end
    else
      quote = '"'
    end
  end

  # Replace single backslashes with multiples.
  contents = contents.gsub("\\", "\\\\\\\\")

  # Escape interpolation.
  contents = contents.gsub('#{', "\\\#{") if opts[:sass]

  if quote == '"'
    contents = contents.gsub('"', "\\\"")
  else
    contents = contents.gsub("'", "\\'")
  end

  contents = contents.gsub(/\n(?![a-fA-F0-9\s])/, "\\a").gsub("\n", "\\a ")
  "#{quote}#{contents}#{quote}"
end

Instance Method Details

#inspect ⇒ Object 



92
93
94
 
# File 'lib/sassc/script/value/string.rb', line 92

def inspect
  String.quote(value)
end

#plus(other) ⇒ Object

See Also:

  • Value#plus


72
73
74
75
76
77
78
79
 
# File 'lib/sassc/script/value/string.rb', line 72

def plus(other)
  if other.is_a?(SassC::Script::Value::String)
    other_value = other.value
  else
    other_value = other.to_s(:quote => :none)
  end
  SassC::Script::Value::String.new(value + other_value, type)
end

#to_s(opts = {}) ⇒ Object

See Also:



82
83
84
85
 
# File 'lib/sassc/script/value/string.rb', line 82

def to_s(opts = {})
  return @value.gsub(/\n\s*/, ' ') if opts[:quote] == :none || @type == :identifier
  self.class.quote(value, opts)
end

#to_sass(opts = {}) ⇒ Object

See Also:



88
89
90
 
# File 'lib/sassc/script/value/string.rb', line 88

def to_sass(opts = {})
  to_s(opts.merge(:sass => true))
end