Class: ActiveSupport::SafeBuffer

Inherits:
String show all
Defined in:
lib/active_support/core_ext/string/output_safety.rb

Defined Under Namespace

Classes: SafeConcatError

Constant Summary collapse

UNSAFE_STRING_METHODS = 
["capitalize", "chomp", "chop", "delete", "downcase", "gsub", "lstrip", "next", "reverse", "rstrip", "slice", "squeeze", "strip", "sub", "succ", "swapcase", "tr", "tr_s", "upcase", "prepend"].freeze

Instance Method Summary collapse

Methods inherited from String

#acts_like_string?, #as_json, #at, #blank?, #camelize, #classify, #constantize, #dasherize, #demodulize, #encode_json, #encoding_aware?, #exclude?, #first, #foreign_key, #from, #html_safe, #humanize, #inquiry, #is_utf8?, #last, #mb_chars, #ord, #parameterize, #pluralize, #singularize, #squish, #squish!, #strip_heredoc, #tableize, #titleize, #to, #to_date, #to_datetime, #to_time, #truncate, #underscore

Constructor Details

#initialize ⇒ SafeBuffer

Returns a new instance of SafeBuffer.



127
128
129
130
 
# File 'lib/active_support/core_ext/string/output_safety.rb', line 127

def initialize(*)
  @html_safe = true
  super
end

Instance Method Details

#+(other) ⇒ Object 



150
151
152
 
# File 'lib/active_support/core_ext/string/output_safety.rb', line 150

def +(other)
  dup.concat(other)
end

#[](*args) ⇒ Object 



110
111
112
113
114
115
116
117
118
119
120
 
# File 'lib/active_support/core_ext/string/output_safety.rb', line 110

def [](*args)
  return super if args.size < 2

  if html_safe?
    new_safe_buffer = super
    new_safe_buffer.instance_eval { @html_safe = true }
    new_safe_buffer
  else
    to_str[*args]
  end
end

#clone_empty ⇒ Object 



137
138
139
 
# File 'lib/active_support/core_ext/string/output_safety.rb', line 137

def clone_empty
  self[0, 0]
end

#concat(value) ⇒ Object Also known as: << 



141
142
143
144
145
146
147
 
# File 'lib/active_support/core_ext/string/output_safety.rb', line 141

def concat(value)
  if !html_safe? || value.html_safe?
    super(value)
  else
    super(ERB::Util.h(value))
  end
end

#encode_with(coder) ⇒ Object 



166
167
168
 
# File 'lib/active_support/core_ext/string/output_safety.rb', line 166

def encode_with(coder)
  coder.represent_scalar nil, to_str
end

#html_safe? ⇒ Boolean

Returns:

  • (Boolean) 


154
155
156
 
# File 'lib/active_support/core_ext/string/output_safety.rb', line 154

def html_safe?
  defined?(@html_safe) && @html_safe
end

#initialize_copy(other) ⇒ Object 



132
133
134
135
 
# File 'lib/active_support/core_ext/string/output_safety.rb', line 132

def initialize_copy(other)
  super
  @html_safe = other.html_safe?
end

#safe_concat(value) ⇒ Object

Raises:



122
123
124
125
 
# File 'lib/active_support/core_ext/string/output_safety.rb', line 122

def safe_concat(value)
  raise SafeConcatError unless html_safe?
  original_concat(value)
end

#to_param ⇒ Object 



162
163
164
 
# File 'lib/active_support/core_ext/string/output_safety.rb', line 162

def to_param
  to_str
end

#to_s ⇒ Object 



158
159
160
 
# File 'lib/active_support/core_ext/string/output_safety.rb', line 158

def to_s
  self
end

#to_yaml(*args) ⇒ Object 



170
171
172
173
 
# File 'lib/active_support/core_ext/string/output_safety.rb', line 170

def to_yaml(*args)
  return super() if defined?(YAML::ENGINE) && !YAML::ENGINE.syck?
  to_str.to_yaml(*args)
end