added map_reserve function with documentation