dual functions, as part of the OO interface.

    It also makes some checks on the raw buffer storage.
    c