zero_copy_stream_impl_lite.h

Retorna um ponteiro para caracteres mutáveis subjacentes à string fornecida.

O valor de retorno será válido até a próxima vez em que a string for redimensionada. Confiamos no autor da chamada para tratar o valor de retorno como uma matriz de tamanho s->size().

Crie um InputStream que retorne os bytes apontados por "dados".

"data" continua sendo a propriedade do autor da chamada, mas precisa permanecer válido até que o stream seja destruído. Se um block_size for definido, as chamadas para Next() retornarão blocos de dados maiores que o tamanho especificado. Caso contrário, a primeira chamada para Next() retorna toda a matriz. O block_size é útil principalmente para testes. Na produção, é provável que não seja recomendado defini-lo.

Recebe um bloco de dados do stream.

Condições prévias:

• "size" e "data" não são NULL.

Pós-condições:

• Se o valor retornado for falso, não haverá mais dados para retornar ou ocorreu um erro. Todos os erros são permanentes.
• Caso contrário, "size" aponta para o número real de bytes lidos e "data" aponta para um ponteiro para um buffer que contém esses bytes.
• A propriedade desse buffer permanece com o stream e ele permanece válido somente até que algum outro método do stream seja chamado ou que o stream seja destruído.
• É permitido que o buffer retornado tenha tamanho zero, desde que chamar Next() várias vezes produz um buffer com tamanho diferente de zero.

Faz backup de vários bytes, de modo que a próxima chamada para Next() retorna dados que já foram retornados pela última chamada para Next().

Isso é útil ao escrever procedimentos que apenas devem ler um certo ponto da entrada e retornar. Se Next() retornar um buffer que vai além do que você quer ler, use BackUp() para voltar ao ponto em que quer concluir.

Condições prévias:

• O último método chamado precisa ter sido Next().
• a contagem deve ser menor ou igual ao tamanho do último buffer retornado por Next().

Pós-condições:

• Os últimos bytes de "count" do último buffer retornados por Next() serão reenviados para o stream. As chamadas subsequentes para Next() retornarão os mesmos dados novamente antes de produzir novos dados.

Ignora vários bytes.

Retorna falso se o final do stream for alcançado ou se ocorrer algum erro de entrada. No caso de fim do stream, ele é avançado para o final (de modo que ByteCount() retorna o tamanho total do stream).

Crie um OutputStream que grave nos bytes apontados por "data".

"data" continua sendo a propriedade do autor da chamada, mas precisa permanecer válido até que o stream seja destruído. Se um block_size for definido, as chamadas para Next() retornarão blocos de dados maiores que o tamanho especificado. Caso contrário, a primeira chamada para Next() retorna toda a matriz. O block_size é útil principalmente para testes. Na produção, é provável que não seja recomendado defini-lo.

Recebe um buffer em que os dados podem ser gravados.

Todos os dados gravados nesse buffer serão gravados na saída (talvez instantaneamente, talvez mais tarde).

Condições prévias:

• "size" e "data" não são NULL.

Pós-condições:

• Se o valor retornado for “false”, significa que ocorreu um erro. Todos os erros são permanentes.
• Caso contrário, "tamanho" apontará para o número real de bytes no buffer e "dados" aponta para o buffer.
• A propriedade desse buffer permanece com o stream e ele permanece válido somente até que algum outro método do stream seja chamado ou que o stream seja destruído.
• Todos os dados armazenados pelo autor da chamada nesse buffer serão gravados na saída (a menos que BackUp() seja chamado).
• É permitido que o buffer retornado tenha tamanho zero, desde que chamar Next() várias vezes produz um buffer com tamanho diferente de zero.

Faz backup de vários bytes, de modo que o fim do último buffer retornado por Next() não seja gravado.

Isso é necessário quando você termina de gravar todos os dados que quer gravar, mas o último buffer foi maior do que o necessário. Não é recomendável escrever vários lixo após o término dos dados, então use BackUp() para fazer backup.

Condições prévias:

• O último método chamado precisa ter sido Next().
• a contagem deve ser menor ou igual ao tamanho do último buffer retornado por Next().
• O autor da chamada não pode ter escrito nada para os últimos bytes de "contagem" desse buffer.

Pós-condições:

• Os últimos bytes de "count" do último buffer retornados por Next() serão ignorados.

Crie um StringOutputStream que anexe bytes à string fornecida.

A string permanece como propriedade do autor da chamada, mas é modificada de maneira arbitrária e NÃO PODE ser acessada de nenhuma forma até o término do stream. Verifique se não há outro uso ou (mais seguro) destrua o stream antes de usar o conteúdo.

Dica: se você chamar target->reserve(n) antes de criar o stream, a primeira chamada para Next() retornará pelo menos n bytes de espaço de buffer.

Recebe um buffer em que os dados podem ser gravados.

Todos os dados gravados nesse buffer serão gravados na saída (talvez instantaneamente, talvez mais tarde).

Condições prévias:

• "size" e "data" não são NULL.

Pós-condições:

• Se o valor retornado for “false”, significa que ocorreu um erro. Todos os erros são permanentes.
• Caso contrário, "tamanho" apontará para o número real de bytes no buffer e "dados" aponta para o buffer.
• A propriedade desse buffer permanece com o stream e ele permanece válido somente até que algum outro método do stream seja chamado ou que o stream seja destruído.
• Todos os dados armazenados pelo autor da chamada nesse buffer serão gravados na saída (a menos que BackUp() seja chamado).
• É permitido que o buffer retornado tenha tamanho zero, desde que chamar Next() várias vezes produz um buffer com tamanho diferente de zero.

Faz backup de vários bytes, de modo que o fim do último buffer retornado por Next() não seja gravado.

Isso é necessário quando você termina de gravar todos os dados que quer gravar, mas o último buffer foi maior do que o necessário. Não é recomendável escrever vários lixo após o término dos dados, então use BackUp() para fazer backup.

Condições prévias:

• O último método chamado precisa ter sido Next().
• a contagem deve ser menor ou igual ao tamanho do último buffer retornado por Next().
• O autor da chamada não pode ter escrito nada para os últimos bytes de "contagem" desse buffer.

Pós-condições:

• Os últimos bytes de "count" do último buffer retornados por Next() serão ignorados.

Lê até "size" bytes no buffer especificado.

Retorna o número de bytes lidos. Read() aguarda até que pelo menos um byte esteja disponível ou retorna zero se nenhum byte estiver disponível (EOF) ou -1 se ocorrer um erro de leitura permanente.

Pula os próximos bytes de "contagem" de entrada.

Retorna o número de bytes realmente ignorados. Ele sempre será exatamente igual a "count", a menos que o EOF tenha sido atingido ou um erro de leitura permanente tenha ocorrido.

A implementação padrão chama repetidamente Read() em um buffer de rascunho.

Cria um stream que lê a partir do COPYInputStream fornecido.

Se um block_size for fornecido, ele especificará o número de bytes que precisam ser lidos e retornados com cada chamada para Next(). Caso contrário, um padrão razoável será usado. O autor da chamada mantém a propriedade de copy_stream, a menos que SetOwnsCOPYStream(true) seja chamado.

Recebe um bloco de dados do stream.

Condições prévias:

• "size" e "data" não são NULL.

Pós-condições:

• Se o valor retornado for falso, não haverá mais dados para retornar ou ocorreu um erro. Todos os erros são permanentes.
• Caso contrário, "size" aponta para o número real de bytes lidos e "data" aponta para um ponteiro para um buffer que contém esses bytes.
• A propriedade desse buffer permanece com o stream e ele permanece válido somente até que algum outro método do stream seja chamado ou que o stream seja destruído.
• É permitido que o buffer retornado tenha tamanho zero, desde que chamar Next() várias vezes produz um buffer com tamanho diferente de zero.

Faz backup de vários bytes, de modo que a próxima chamada para Next() retorna dados que já foram retornados pela última chamada para Next().

Isso é útil ao escrever procedimentos que apenas devem ler um certo ponto da entrada e retornar. Se Next() retornar um buffer que vai além do que você quer ler, use BackUp() para voltar ao ponto em que quer concluir.

Condições prévias:

• O último método chamado precisa ter sido Next().
• a contagem deve ser menor ou igual ao tamanho do último buffer retornado por Next().

Pós-condições:

• Os últimos bytes de "count" do último buffer retornados por Next() serão reenviados para o stream. As chamadas subsequentes para Next() retornarão os mesmos dados novamente antes de produzir novos dados.

Ignora vários bytes.

Retorna falso se o final do stream for alcançado ou se ocorrer algum erro de entrada. No caso de fim do stream, ele é avançado para o final (de modo que ByteCount() retorna o tamanho total do stream).

Grava bytes "size" do buffer especificado na saída.

Retornará "true" se for bem-sucedido. "False" em um erro de gravação.

Cria um stream que grava no descritor de arquivo Unix fornecido.

Se um block_size for informado, ele especificará o tamanho dos buffers que serão retornados por Next(). Caso contrário, um padrão razoável será usado.

Grava todos os dados pendentes no stream subjacente.

Retorna "false" se um erro de gravação ocorreu no stream subjacente. O stream em si não é necessariamente limpo.

Recebe um buffer em que os dados podem ser gravados.

Todos os dados gravados nesse buffer serão gravados na saída (talvez instantaneamente, talvez mais tarde).

Condições prévias:

• "size" e "data" não são NULL.

Pós-condições:

• Se o valor retornado for “false”, significa que ocorreu um erro. Todos os erros são permanentes.
• Caso contrário, "tamanho" apontará para o número real de bytes no buffer e "dados" aponta para o buffer.
• A propriedade desse buffer permanece com o stream e ele permanece válido somente até que algum outro método do stream seja chamado ou que o stream seja destruído.
• Todos os dados armazenados pelo autor da chamada nesse buffer serão gravados na saída (a menos que BackUp() seja chamado).
• É permitido que o buffer retornado tenha tamanho zero, desde que chamar Next() várias vezes produz um buffer com tamanho diferente de zero.

Faz backup de vários bytes, de modo que o fim do último buffer retornado por Next() não seja gravado.

Isso é necessário quando você termina de gravar todos os dados que quer gravar, mas o último buffer foi maior do que o necessário. Não é recomendável escrever vários lixo após o término dos dados, então use BackUp() para fazer backup.

Condições prévias:

• O último método chamado precisa ter sido Next().
• a contagem deve ser menor ou igual ao tamanho do último buffer retornado por Next().
• O autor da chamada não pode ter escrito nada para os últimos bytes de "contagem" desse buffer.

Pós-condições:

• Os últimos bytes de "count" do último buffer retornados por Next() serão ignorados.

Gravar um determinado bloco de dados na saída.

Alguns streams de saída podem implementar isso de modo a evitar a cópia. Verifique AllowAliasing() antes de chamar WriteAliasedRaw(). Ocorrerá uma falha na GOOGLE_CHECK se o WriteAliasedRaw() for chamado em um stream que não permita o alias.

OBSERVAÇÃO: é responsabilidade do autor da chamada garantir que o bloco de memória permaneça ativo até que todos os dados tenham sido consumidos pelo stream.

Recebe um bloco de dados do stream.

Condições prévias:

• "size" e "data" não são NULL.

Pós-condições:

• Se o valor retornado for falso, não haverá mais dados para retornar ou ocorreu um erro. Todos os erros são permanentes.
• Caso contrário, "size" aponta para o número real de bytes lidos e "data" aponta para um ponteiro para um buffer que contém esses bytes.
• A propriedade desse buffer permanece com o stream e ele permanece válido somente até que algum outro método do stream seja chamado ou que o stream seja destruído.
• É permitido que o buffer retornado tenha tamanho zero, desde que chamar Next() várias vezes produz um buffer com tamanho diferente de zero.

Faz backup de vários bytes, de modo que a próxima chamada para Next() retorna dados que já foram retornados pela última chamada para Next().

Isso é útil ao escrever procedimentos que apenas devem ler um certo ponto da entrada e retornar. Se Next() retornar um buffer que vai além do que você quer ler, use BackUp() para voltar ao ponto em que quer concluir.

Condições prévias:

• O último método chamado precisa ter sido Next().
• a contagem deve ser menor ou igual ao tamanho do último buffer retornado por Next().

Pós-condições:

• Os últimos bytes de "count" do último buffer retornados por Next() serão reenviados para o stream. As chamadas subsequentes para Next() retornarão os mesmos dados novamente antes de produzir novos dados.

Ignora vários bytes.

Retorna falso se o final do stream for alcançado ou se ocorrer algum erro de entrada. No caso de fim do stream, ele é avançado para o final (de modo que ByteCount() retorna o tamanho total do stream).