SkData.h

Go to the documentation of this file.

/*
 * Copyright 2011 Google Inc.
 *
 * Use of this source code is governed by a BSD-style license that can be
 * found in the LICENSE file.
 */
 
#ifndef SkData_DEFINED
#define SkData_DEFINED
 
#include "include/core/SkRefCnt.h"
#include "include/private/base/SkAPI.h"
#include "include/private/base/SkAssert.h"
 
#include <cstdint>
#include <cstdio>
 
class SkStream;
 
class SK_API SkData final : public SkNVRefCnt<SkData> {
public:
    size_t size() const { return fSize; }
 
    bool isEmpty() const { return 0 == fSize; }
 
    const void* data() const { return fPtr; }
 
    const uint8_t* bytes() const {
        return reinterpret_cast<const uint8_t*>(fPtr);
    }
 
    void* writable_data() {
        if (fSize) {
            // only assert we're unique if we're not empty
            SkASSERT(this->unique());
        }
        return const_cast<void*>(fPtr);
    }
 
    size_t copyRange(size_t offset, size_t length, void* buffer) const;
 
    bool equals(const SkData* other) const;
 
    typedef void (*ReleaseProc)(const void* ptr, void* context);
 
    static sk_sp<SkData> MakeWithCopy(const void* data, size_t length);
 
 
    static sk_sp<SkData> MakeUninitialized(size_t length);
 
    static sk_sp<SkData> MakeZeroInitialized(size_t length);
 
    static sk_sp<SkData> MakeWithCString(const char cstr[]);
 
    static sk_sp<SkData> MakeWithProc(const void* ptr, size_t length, ReleaseProc proc, void* ctx);
 
    static sk_sp<SkData> MakeWithoutCopy(const void* data, size_t length) {
        return MakeWithProc(data, length, NoopReleaseProc, nullptr);
    }
 
    static sk_sp<SkData> MakeFromMalloc(const void* data, size_t length);
 
    static sk_sp<SkData> MakeFromFileName(const char path[]);
 
    static sk_sp<SkData> MakeFromFILE(FILE* f);
 
    static sk_sp<SkData> MakeFromFD(int fd);
 
    static sk_sp<SkData> MakeFromStream(SkStream*, size_t size);
 
    static sk_sp<SkData> MakeSubset(const SkData* src, size_t offset, size_t length);
 
    static sk_sp<SkData> MakeEmpty();
 
private:
    friend class SkNVRefCnt<SkData>;
    ReleaseProc fReleaseProc;
    void*       fReleaseProcContext;
    const void* fPtr;
    size_t      fSize;
 
    SkData(const void* ptr, size_t size, ReleaseProc, void* context);
    explicit SkData(size_t size);   // inplace new/delete
    ~SkData();
 
    // Ensure the unsized delete is called.
    void operator delete(void* p);
 
    // shared internal factory
    static sk_sp<SkData> PrivateNewWithCopy(const void* srcOrNull, size_t length);
 
    static void NoopReleaseProc(const void*, void*); // {}
 
    using INHERITED = SkRefCnt;
};
 
#endif