Co robi komentarz "frozen_string_literal: true"?

Question

To jest binstub rspec w moim katalogu projektu.

#!/usr/bin/env ruby 
begin 
    load File.expand_path("../spring", __FILE__) 
rescue LoadError 
end 
# frozen_string_literal: true 
# 
# This file was generated by Bundler. 
# 
# The application 'rspec' is installed as part of a gem, and 
# this file is here to facilitate running it. 
# 

require "pathname" 
ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile", 
    Pathname.new(__FILE__).realpath) 

require "rubygems" 
require "bundler/setup" 

load Gem.bin_path("rspec-core", "rspec") 

Co to ma zrobić?

# frozen_string_literal: true 

Answer 1

# frozen_string_literal: true to magiczne komentarz, wspierany po raz pierwszy w Ruby 2.3, który mówi, że wszystkie Ruby literały ciągów znaków w pliku są niejawnie zamrożone, jakby #freeze został powołany na każdym z nich. To znaczy, jeśli literał łańcuchowy jest zdefiniowany w pliku z tym komentarzem, a ty wywołujesz metodę na tym łańcuchu, który ją modyfikuje, na przykład <<, otrzymasz RuntimeError: can't modify frozen String.

Komentarz musi znajdować się w pierwszym wierszu pliku.

W Ruby 2.3, można użyć tego magicznego komentarz do przygotowania zamrożonych napisowych będących domyślny w Ruby 3.

w Ruby 2.3 biegu z flagą --enable=frozen-string-literal, aw Ruby 3 literały łańcuchowe są zamrożone wszystkie pliki. Możesz zmienić ustawienie globalne na # frozen_string_literal: false.

Jeśli chcesz ciąg dosłownego być zmienny niezależnie od globalnej lub ustawienia dla pliku można poprzedzić go z jednoargumentowego + operatora (uważając z pierwszeństwa operatora) lub zadzwoń .dup na nim:

# frozen_string_literal: true 
"".frozen? 
=> true 
(+"").frozen? 
=> false 
"".dup.frozen? 
=> false 

Można także zamrozić zmienny (niezamrożony) ciąg z unarnym -.