класс CSV::Table

# File lib/csv.rb, line 784
def <<(row_or_array)
  if row_or_array.is_a? Array  # append Array
    @table << Row.new(headers, row_or_array)
  else                         # append Row
    @table << row_or_array
  end

  self  # for chaining
end

Добавляет новую строку в конец этой таблицы. Вы можете предоставить массив, который будет преобразован в CSV::Row (унаследующий заголовки таблицы headers()), или CSV::Row.

Этот метод возвращает таблицу для цепочки вызовов.

# File lib/csv.rb, line 871
def ==(other)
  @table == other.table
end

Возвращает true если все строки этой таблицы ==() other строки.

# File lib/csv.rb, line 700
def [](index_or_header)
  if @mode == :row or  # by index
     (@mode == :col_or_row and (index_or_header.is_a?(Integer) or index_or_header.is_a?(Range)))
    @table[index_or_header]
  else                 # by header
    @table.map { |row| row[index_or_header] }
  end
end

В режиме по умолчанию (смешанный режим) этот метод возвращает строки для доступа по индексу и столбцы для доступа по заголовкам. Вы можете принудительно задать ассоциацию по индексу, вызвав сначала #by_col!() или #by_row!().

Столбцы возвращаются как массив значений. Изменение этого массива не влияет на таблицу.

# File lib/csv.rb, line 725
def []=(index_or_header, value)
  if @mode == :row or  # by index
     (@mode == :col_or_row and index_or_header.is_a? Integer)
    if value.is_a? Array
      @table[index_or_header] = Row.new(headers, value)
    else
      @table[index_or_header] = value
    end
  else                 # set column
    if value.is_a? Array  # multiple values
      @table.each_with_index do |row, i|
        if row.header_row?
          row[index_or_header] = index_or_header
        else
          row[index_or_header] = value[i]
        end
      end
    else                  # repeated value
      @table.each do |row|
        if row.header_row?
          row[index_or_header] = index_or_header
        else
          row[index_or_header] = value
        end
      end
    end
  end
end

В режиме по умолчанию (смешанный режим) этот метод присваивает строки для доступа по индексу и столбцы для доступа по заголовкам. Вы можете принудительно задать ассоциацию по индексу, вызвав сначала #by_col!() или #by_row!().

Строки могут быть заданы как массив значений (который унаследует заголовки таблицы) или CSV::Row.

Столбцы могут быть заданы одним значением, которое копируется в каждую строку столбца, или массивом значений. Массивы значений присваиваются строкам сверху вниз в порядке следования строк. Избыточные значения игнорируются, и если у массива нет значения для каждой строки, дополнительные строки получат nil.

Присвоение существующему столбцу или строке перезаписывает данные. Присвоение новым столбцам создаёт их в правой части таблицы.

# File lib/csv.rb, line 612
def by_col
  self.class.new(@table.dup).by_col!
end

Возвращает дубликат объекта таблицы в режиме столбцов. Это удобно для цепочки вызовов без изменения режима таблицы, но имейте в виду, что этот метод может потреблять значительное количество памяти для больших наборов данных.

Этот метод возвращает дубликат таблицы для цепочки вызовов. Однако не цепляйте деструктивные методы (например, []=()) таким образом, так как вы работаете с дубликатом.

# File lib/csv.rb, line 622
def by_col!
  @mode = :col

  self
end

Переключает режим этой таблицы на режим столбцов. Все вызовы методов индексирования и итерации будут работать со столбцами, пока режим не будет изменён снова.

Этот метод возвращает таблицу и безопасен для цепочки вызовов.

# File lib/csv.rb, line 637
def by_col_or_row
  self.class.new(@table.dup).by_col_or_row!
end

Возвращает дубликат объекта таблицы в смешанном режиме. Это удобно для цепочки вызовов без изменения режима таблицы, но имейте в виду, что этот метод может потреблять значительное количество памяти для больших наборов данных.

Этот метод возвращает дубликат таблицы для цепочки вызовов. Однако не цепляйте деструктивные методы (например, []=()) таким образом, так как вы работаете с дубликатом.

# File lib/csv.rb, line 649
def by_col_or_row!
  @mode = :col_or_row

  self
end

Переключает режим этой таблицы на смешанный режим. Все вызовы методов индексирования и итерации будут использовать стандартную интеллектуальную систему индексирования до тех пор, пока режим не будет изменён снова. В смешанном режиме индекс предполагается как ссылка на строку, а всё остальное - как доступ к столбцам по заголовкам.

Этот метод возвращает таблицу и безопасен для цепочки вызовов.

# File lib/csv.rb, line 664
def by_row
  self.class.new(@table.dup).by_row!
end

Возвращает дубликат объекта таблицы в режиме строк. Это удобно для цепочки вызовов без изменения режима таблицы, но имейте в виду, что этот метод может потреблять значительное количество памяти для больших наборов данных.

Этот метод возвращает дубликат таблицы для цепочки вызовов. Однако не цепляйте деструктивные методы (например, []=()) таким образом, так как вы работаете с дубликатом.

# File lib/csv.rb, line 674
def by_row!
  @mode = :row

  self
end

Переключает режим этой таблицы на режим строк. Все вызовы методов индексирования и итерации будут работать со строками, пока режим не будет изменён снова.

Этот метод возвращает таблицу и безопасен для цепочки вызовов.

# File lib/csv.rb, line 812
def delete(index_or_header)
  if @mode == :row or  # by index
     (@mode == :col_or_row and index_or_header.is_a? Integer)
    @table.delete_at(index_or_header)
  else                 # by header
    @table.map { |row| row.delete(index_or_header).last }
  end
end

Удаляет и возвращает указанный столбец или строку. В режиме по умолчанию (смешанный режим) индексы относятся к строкам, а всё остальное - к заголовкам столбцов. Используйте #by_col!() или #by_row!() для принудительного поиска.

# File lib/csv.rb, line 763
def values_at(*indices_or_headers)
  if @mode == :row or  # by indices
     ( @mode == :col_or_row and indices_or_headers.all? do |index|
                                  index.is_a?(Integer)         or
                                  ( index.is_a?(Range)         and
                                    index.first.is_a?(Integer) and
                                    index.last.is_a?(Integer) )
                                end )
    @table.values_at(*indices_or_headers)
  else                 # by headers
    @table.map { |row| row.values_at(*indices_or_headers) }
  end
end

По умолчанию в смешанном режиме список индексов обрабатывается как доступ к строкам, возвращая указанные строки. Всё остальное рассматривается как доступ к столбцам. При доступе к столбцам возвращаемый набор содержит массив для каждой строки, содержащий значения, указанные в заголовках в каждом массиве. Вы можете принудительно задать режим столбцов или строк, используя #by_col!() или #by_row!().

Смешанный доступ к столбцам и строкам невозможен.