formats/pdf/object_reader.h

// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//    https://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
//

#ifndef THIRD_PARTY_CREDENTIO_FORMATS_PDF_OBJECT_READER_H_
#define THIRD_PARTY_CREDENTIO_FORMATS_PDF_OBJECT_READER_H_

#include <cstdint>

#include "absl/functional/any_invocable.h"
#include "absl/status/status.h"
#include "absl/status/statusor.h"
#include "formats/pdf/objects.h"
#include "riegeli/bytes/reader.h"

namespace credentio {

// Reads a PDF object from the given input stream at the given offset.
absl::Status ReadObject(riegeli::Reader& input, int64_t obj_offset, Object& obj,
                        int depth = 0);

// Reads a PDF indirect object from the given input stream at the given offset.
// `indirect_reference_resolver` is used to resolve any indirect references
// encountered during the reading process.
absl::Status ReadIndirectObject(
    riegeli::Reader& input, int64_t obj_offset,
    absl::AnyInvocable<
        absl::StatusOr<IndirectObject>(const Object::IndirectReference&)>
        indirect_reference_resolver,
    IndirectObject& obj);

// Reads and skips over white-space characters and comments until the first
// non-whitespace, non-comment character is encountered.
absl::Status SkipOverWhiteSpaces(riegeli::Reader& input);

}  // namespace credentio

#endif  // THIRD_PARTY_CREDENTIO_FORMATS_PDF_OBJECT_READER_H_