# encoding: UTF-8 module Axlsx # The Shared String Table class is responsible for managing and serializing common strings in a workbook. # While the ECMA-376 spec allows for both inline and shared strings it seems that at least some applications like iWorks Numbers # and Google Docs require that the shared string table is populated in order to interoperate properly. # As a developer, you should never need to directly work against this class. Simply set 'use_shared_strings' # on the package or workbook to generate a package that uses the shared strings table instead of inline strings. # @note Serialization performance is affected by using this serialization method so if you do not need interoperability # it is recomended that you use the default inline string method of serialization. class SharedStringsTable # The total number of strings in the workbook including duplicates # Empty cells are treated as blank strings # @return [Integer] attr_reader :count # The total number of unique strings in the workbook. # @return [Integer] def unique_count @unique_cells.size end # An array of unique cells. Multiple attributes of the cell are used in comparison # each of these unique cells is parsed into the shared string table. # @see Cell#sharable attr_reader :unique_cells # Creates a new Shared Strings Table agains an array of cells # @param [Array] cells This is an array of all of the cells in the workbook def initialize(cells) cells = cells.flatten.reject { |c| c.type != :string || c.value.nil? || c.value.start_with?('=') } @count = cells.size @unique_cells = [] @shared_xml_string = "" resolve(cells) end # Serializes the object # @param [String] str # @return [String] def to_xml_string '' << @shared_xml_string << '' end private # Interate over all of the cells in the array. # if our unique cells array does not contain a sharable cell, # add the cell to our unique cells array and set the ssti attribute on the index of this cell in the shared strings table # if a sharable cell already exists in our unique_cells array, set the ssti attribute of the cell and move on. # @return [Array] unique cells def resolve(cells) cells.each do |cell| cell_hash = cell.shareable_hash index = @unique_cells.index do |item| item == cell_hash end if index == nil cell.send :ssti=, @unique_cells.size @shared_xml_string << '' << cell.run_xml_string << '' @unique_cells << cell_hash else cell.send :ssti=, index end end end end end