diff --git a/src/libstd/ptr.rs b/src/libstd/ptr.rs index e2dda82676589..162e46c53aecd 100644 --- a/src/libstd/ptr.rs +++ b/src/libstd/ptr.rs @@ -21,7 +21,9 @@ use util::swap; #[cfg(not(test))] use cmp::{Eq, Ord}; -/// Calculate the offset from a pointer +/// Calculate the offset from a pointer. +/// The `count` argument is in units of T; e.g. a `count` of 3 +/// represents a pointer offset of `3 * sizeof::()` bytes. #[inline] pub unsafe fn offset(ptr: *T, count: int) -> *T { intrinsics::offset(ptr, count) @@ -29,6 +31,8 @@ pub unsafe fn offset(ptr: *T, count: int) -> *T { /// Calculate the offset from a mut pointer. The count *must* be in bounds or /// otherwise the loads of this address are undefined. +/// The `count` argument is in units of T; e.g. a `count` of 3 +/// represents a pointer offset of `3 * sizeof::()` bytes. #[inline] pub unsafe fn mut_offset(ptr: *mut T, count: int) -> *mut T { intrinsics::offset(ptr as *T, count) as *mut T