Class: ActiveSupport::SafeBuffer

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

Direct Known Subclasses

ActionView::OutputBuffer

Defined Under Namespace

Classes: SafeConcatError

Constant Summary collapse

UNSAFE_STRING_METHODS =
%w(
  capitalize chomp chop delete delete_prefix delete_suffix
  downcase lstrip next reverse rstrip slice squeeze strip
  succ swapcase tr tr_s unicode_normalize upcase
)
UNSAFE_STRING_METHODS_WITH_BACKREF =
%w(gsub sub)

Constants inherited from String

String::BLANK_RE, String::ENCODED_BLANKS

Instance Method Summary collapse

Methods inherited from String

#acts_like_string?, #as_json, #at, #blank?, #camelize, #classify, #constantize, #dasherize, #deconstantize, #demodulize, #exclude?, #first, #foreign_key, #from, #html_safe, #humanize, #in_time_zone, #indent, #indent!, #inquiry, #is_utf8?, #last, #mb_chars, #parameterize, #pluralize, #remove, #remove!, #safe_constantize, #singularize, #squish, #squish!, #strip_heredoc, #tableize, #titleize, #to, #to_date, #to_datetime, #to_time, #truncate, #truncate_bytes, #truncate_words, #underscore, #upcase_first

Constructor Details

#initialize(str = "") ⇒ SafeBuffer

Returns a new instance of SafeBuffer.


172
173
174
175
# File 'activesupport/lib/active_support/core_ext/string/output_safety.rb', line 172

def initialize(str = "")
  @html_safe = true
  super
end

Instance Method Details

#%(args) ⇒ Object


221
222
223
224
225
226
227
228
229
230
# File 'activesupport/lib/active_support/core_ext/string/output_safety.rb', line 221

def %(args)
  case args
  when Hash
    escaped_args = args.transform_values { |arg| html_escape_interpolated_argument(arg) }
  else
    escaped_args = Array(args).map { |arg| html_escape_interpolated_argument(arg) }
  end

  self.class.new(super(escaped_args))
end

#*Object


215
216
217
218
219
# File 'activesupport/lib/active_support/core_ext/string/output_safety.rb', line 215

def *(*)
  new_safe_buffer = super
  new_safe_buffer.instance_variable_set(:@html_safe, @html_safe)
  new_safe_buffer
end

#+(other) ⇒ Object


211
212
213
# File 'activesupport/lib/active_support/core_ext/string/output_safety.rb', line 211

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

#[](*args) ⇒ Object


153
154
155
156
157
158
159
160
161
162
163
164
165
# File 'activesupport/lib/active_support/core_ext/string/output_safety.rb', line 153

def [](*args)
  if html_safe?
    new_safe_buffer = super

    if new_safe_buffer
      new_safe_buffer.instance_variable_set :@html_safe, true
    end

    new_safe_buffer
  else
    to_str[*args]
  end
end

#[]=(*args) ⇒ Object


203
204
205
206
207
208
209
# File 'activesupport/lib/active_support/core_ext/string/output_safety.rb', line 203

def []=(*args)
  if args.length == 3
    super(args[0], args[1], html_escape_interpolated_argument(args[2]))
  else
    super(args[0], html_escape_interpolated_argument(args[1]))
  end
end

#clone_emptyObject


182
183
184
# File 'activesupport/lib/active_support/core_ext/string/output_safety.rb', line 182

def clone_empty
  self[0, 0]
end

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


186
187
188
# File 'activesupport/lib/active_support/core_ext/string/output_safety.rb', line 186

def concat(value)
  super(html_escape_interpolated_argument(value))
end

#encode_with(coder) ⇒ Object


244
245
246
# File 'activesupport/lib/active_support/core_ext/string/output_safety.rb', line 244

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

#html_safe?Boolean

Returns:

  • (Boolean)

232
233
234
# File 'activesupport/lib/active_support/core_ext/string/output_safety.rb', line 232

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

#initialize_copy(other) ⇒ Object


177
178
179
180
# File 'activesupport/lib/active_support/core_ext/string/output_safety.rb', line 177

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

#insert(index, value) ⇒ Object


191
192
193
# File 'activesupport/lib/active_support/core_ext/string/output_safety.rb', line 191

def insert(index, value)
  super(index, html_escape_interpolated_argument(value))
end

#prepend(value) ⇒ Object


195
196
197
# File 'activesupport/lib/active_support/core_ext/string/output_safety.rb', line 195

def prepend(value)
  super(html_escape_interpolated_argument(value))
end

#replace(value) ⇒ Object


199
200
201
# File 'activesupport/lib/active_support/core_ext/string/output_safety.rb', line 199

def replace(value)
  super(html_escape_interpolated_argument(value))
end

#safe_concat(value) ⇒ Object

Raises:


167
168
169
170
# File 'activesupport/lib/active_support/core_ext/string/output_safety.rb', line 167

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

#to_paramObject


240
241
242
# File 'activesupport/lib/active_support/core_ext/string/output_safety.rb', line 240

def to_param
  to_str
end

#to_sObject


236
237
238
# File 'activesupport/lib/active_support/core_ext/string/output_safety.rb', line 236

def to_s
  self
end