Update docs and names to reflect actual behavior

The length map has been a size map all along

Author: danielwe

README.md

@@ -185,9 +185,8 @@ LazyBufferCache(f::F=identity)
 ```
 
 A `LazyBufferCache` is a `Dict`-like type for the caches which automatically defines
-new cache vectors on demand when they are required. The function `f` is a length
-map which maps `length_of_cache = f(length(u))`, which by default creates cache
-vectors of the same length.
+new cache arrays on demand when they are required. The function `f` maps
+`size_of_cache = f(size(u))`, which by default creates cache arrays of the same size.
 
 Note that `LazyBufferCache` does cause a dynamic dispatch, though it is type-stable.
 This gives it a ~100ns overhead, and thus on very small problems it can reduce

src/PreallocationTools.jl

@@ -75,22 +75,22 @@ end
 """
     b = LazyBufferCache(f=identity)
 
-A lazily allocated buffer object.  Given a vector `u`, `b[u]` returns a `Vector` of the
-same element type and length `f(length(u))` (defaulting to the same length), which is
-allocated as needed and then cached within `b` for subsequent usage.
+A lazily allocated buffer object.  Given an array `u`, `b[u]` returns an array of the
+same type and size `f(size(u))` (defaulting to the same size), which is allocated as
+needed and then cached within `b` for subsequent usage.
 
 """
 struct LazyBufferCache{F<:Function}
     bufs::Dict # a dictionary mapping types to buffers
-    lengthmap::F
+    sizemap::F
     LazyBufferCache(f::F=identity) where {F<:Function} = new{F}(Dict(), f) # start with empty dict
 end
 
 # override the [] method
 function Base.getindex(b::LazyBufferCache, u::T) where {T<:AbstractArray}
-    n = b.lengthmap(size(u)) # required buffer length
-    buf = get!(b.bufs, (T, n)) do
-        similar(u, n) # buffer to allocate if it was not found in b.bufs
+    s = b.sizemap(size(u)) # required buffer size
+    buf = get!(b.bufs, (T, s)) do
+        similar(u, s) # buffer to allocate if it was not found in b.bufs
     end::T # declare type since b.bufs dictionary is untyped
     return buf
 end