Class ArrayUtils

libsolidity/codegen/ArrayUtils.h:38–114

* Class that provides code generation for handling arrays. */

 * Class that provides code generation for handling arrays.
 */
class ArrayUtils
{
public:
	explicit ArrayUtils(CompilerContext& _context): m_context(_context) {}

	/// Copies an array to an array in storage. The arrays can be of different types only if
	/// their storage representation is the same.
	/// Stack pre: source_reference [source_length] target_reference
	/// Stack post: target_reference
	void copyArrayToStorage(ArrayType const& _targetType, ArrayType const& _sourceType) const;
	/// Copies the data part of an array (which cannot be dynamically nested) from anywhere
	/// to a given position in memory.
	/// This always copies contained data as is (i.e. structs and fixed-size arrays are copied in
	/// place as required by the ABI encoding). Use CompilerUtils::convertType if you want real
	/// memory copies of nested arrays.
	/// Stack pre: memory_offset source_item
	/// Stack post: memory_offset + length(padded)
	void copyArrayToMemory(ArrayType const& _sourceType, bool _padToWordBoundaries = true) const;
	/// Clears the given dynamic or static array.
	/// Stack pre: storage_ref storage_byte_offset
	/// Stack post:
	void clearArray(ArrayType const& _type) const;
	/// Clears the length and data elements of the array referenced on the stack.
	/// Stack pre: reference (excludes byte offset)
	/// Stack post:
	void clearDynamicArray(ArrayType const& _type) const;
	/// Increments the size of a dynamic array by one.
	/// Does not touch the new data element. In case of a byte array, this might move the
	/// data.
	/// Stack pre: reference (excludes byte offset)
	/// Stack post: new_length
	void incrementDynamicArraySize(ArrayType const& _type) const;
	/// Decrements the size of a dynamic array by one if length is nonzero. Causes a Panic otherwise.
	/// Clears the removed data element. In case of a byte array, this might move the data.
	/// Stack pre: reference
	/// Stack post:
	void popStorageArrayElement(ArrayType const& _type) const;
	/// Appends a loop that clears a sequence of storage slots of the given type.
	/// Stack pre: start_ref slot_count
	/// Stack post:
	void clearStorageLoop(Type const* _type) const;
	/// Converts length to size (number of storage slots or calldata/memory bytes).
	/// if @a _pad then add padding to multiples of 32 bytes for calldata/memory.
	/// Stack pre: length
	/// Stack post: size
	void convertLengthToSize(ArrayType const& _arrayType, bool _pad = false) const;
	/// Retrieves the length (number of elements) of the array ref on the stack. This also
	/// works for statically-sized arrays.
	/// @param _stackDepth number of stack elements between top of stack and top (!) of reference
	/// Stack pre: reference (excludes byte offset for dynamic storage arrays)
	/// Stack post: reference length
	void retrieveLength(ArrayType const& _arrayType, unsigned _stackDepth = 0) const;
	/// Stores the length of an array of type @a _arrayType in storage. The length itself is stored
	/// on the stack at position @a _stackDepthLength and the storage reference at @a _stackDepthRef.
	/// If @a _arrayType is a byte array, takes tight coding into account.
	void storeLength(ArrayType const& _arrayType, unsigned _stackDepthLength = 0, unsigned _stackDepthRef = 1) const;
	/// Checks whether the index is out of range and returns the absolute offset of the element reference[index]
	/// (i.e. reference + index * size_of_base_type).