class ReadAccessor : public virtual FileAccessor {...};
ReadAccessor is used to read file data. It provides binary and text mode methods for checking or getting the current byte/character (PeekByte/PeekChar, GetByte/GetChar) methods for reading a section of a binary/text file (Read Binary/ReadText), a method to read a line of text (ReadLine).
Permite a leitura por blocos, por linhas ou baseada em caracteres de dados de arquivos e binários persistidos.
GERADO POR IAnão revisadoModelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: 811820211677ProcedênciaPerguntas em aberto (1)
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão
Permite a leitura por blocos, por linhas ou baseada em caracteres de dados de arquivos e binários persistidos.
A classe ara::per::ReadAccessor disponibiliza métodos síncronos para a leitura sequencial e baseada em linhas de arquivos em modo binário e de texto [SWS_PER_00421], [SWS_PER_00119]. Além da leitura consumidora, permite a pré-visualização neutra em relação a ponteiros dos bytes ou caracteres seguintes. Como as instâncias não são thread-safe, os acessos paralelos devem ser coordenados externamente, enquanto, em caso de erro, uma garantia de rollback protege a posição do ponteiro de leitura [SWS_PER_00419].
Contexto e escopo de tarefas
A classe ara::per::ReadAccessor disponibiliza uma interface para a leitura síncrona de conteúdos de arquivos no gerenciamento de persistência (módulo per) e herda virtualmente de FileAccessor. Ela abstrai o acesso de leitura a armazenamentos de dados persistidos e disponibiliza métodos de acesso tanto binários quanto textuais. As aplicações podem, por meio de funções especializadas, verificar e obter bytes ou caracteres individuais, bem como ler blocos contíguos ou linhas completas.
Ciclo de vida e concorrência
O construtor padrão de ReadAccessor é excluído [SWS_PER_00461]; portanto, a instanciação ocorre tipicamente mediada por mecanismos superiores de abertura e acesso do módulo de persistência. A liberação da interface e dos recursos de acesso vinculados ocorre por meio do destrutor virtual ~ReadAccessor()[SWS_PER_00417]. As instâncias de ReadAccessor possuem um ponteiro de leitura interno que gerencia a posição atual no arquivo. Todos os métodos da classe são explicitamente especificados como não thread-safe (not thread-safe) [SWS_PER_00419], razão pela qual operações de leitura simultâneas na mesma instância devem ser sincronizadas externamente pelos chamadores.
Caminhos de uso para dados binários e de texto
Para operações com arquivos binários, a classe oferece funções para leitura com pré-visualização ou sequencial. Com PeekByte(), o byte na posição de leitura atual pode ser inspecionado sem alterar o ponteiro de leitura [SWS_PER_00418]. Por outro lado, GetByte() lê exatamente um byte e avança a posição [SWS_PER_00419]. Blocos de dados maiores podem ser lidos por meio de ReadBinary(n) em um ara::core::Vector<ara::core::Byte>, sendo a posição ajustada adequadamente; se o final do arquivo for alcançado prematuramente, o vetor conterá menos bytes do que o solicitado [SWS_PER_00422]. Por meio de ReadBinary(), todos os bytes restantes até o final do arquivo podem ser obtidos em uma única etapa [SWS_PER_00421].
Diagrama de sequência: fluxo típico de um acesso de leitura sequencial com verificação prévia e processamento de dados por seções. Fontes: [SWS_PER_00418], [SWS_PER_00422], [SWS_PER_00421].
No modo de texto, PeekChar() disponibiliza uma pré-visualização baseada em caracteres [SWS_PER_00167], enquanto GetChar() consome o caractere seguinte [SWS_PER_00168]. A leitura por linhas ocorre por meio de ReadLine(), que lê até um delimitador (padrão: '\n', ASCII 0x0a); o delimitador não é incorporado à string de resultado [SWS_PER_00119]. Seções de n caracteres ou todo o conteúdo restante podem ser lidos por meio das sobrecargas de ReadText()[SWS_PER_00165], [SWS_PER_00420]. Se o ponteiro de leitura estiver no meio de um caractere multibyte, as cadeias de caracteres resultantes podem apresentar pontos de código Unicode incompletos [SWS_PER_00119], [SWS_PER_00165].
Cenários de erro e tratamento de erros
Todas as operações de leitura de ReadAccessor retornam seus valores encapsulados em um ara::core::Result e são especificadas como seguras contra exceções (exception safe) [SWS_PER_00419]. Se ocorrer um erro durante um acesso, aplica-se uma semântica estrita de rollback: a posição atual do ponteiro de leitura permanece sempre inalterada em caso de erro [SWS_PER_00421], [SWS_PER_00422]. Os estados de erro típicos documentados abrangem:
Reads all remaining bytes into a Vector of Byte, starting from the current position. The current position is set to the end of the file. In case of an error, the current position is not changed.
Reads a complete line of characters into a String, advancing the current position accordingly. The end of the line is demarcated by the delimiter, or by "\\n" (ASCII 0x0a) if that parameter is omitted. The delimiter itself is not included in the returned String. Only Unicode code points with one character (code unit) can be used as delimiters. The returned string may start with an incomplete Unicode code point in case the current read position is in the middle of a code point. If the end of the file is reached, the remaining characters are returned and the current position is set to the end of the file. In case of an error, the current position is not changed.
Reads a number of characters into a String, starting from the current position. The returned string may start and/or end with incomplete Unicode code points in case the current read position and/or the last read character (code unit) is in the middle of a code point. The current position is advanced accordingly. If the end of the file is reached, the number of returned characters can be less than the requested number, and the current position is set to the end of the file. In case of an error, the current position is not changed.
Returns the byte at the current position of the file. The current position is not changed.
GERADO POR IAnão revisadoModelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: eb387be6a3cfProcedênciaPerguntas em aberto (1)
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão
A função-membro síncrona PeekByte da classe ara::per::ReadAccessor lê um único byte na posição atual do ficheiro sem alterar a posição do ficheiro [SWS_PER_00418]. A função requer a inclusão do cabeçalho ara/per/read_accessor.h, não recebe parâmetros e devolve o valor lido num ara::core::Result<ara::core::Byte>[SWS_PER_00418].
Se ocorrer um erro durante o acesso, o objeto de retorno contém ou um código de erro específico do fabricante ou um dos erros definidos de PerErrc[SWS_PER_00418]:
PerErrc::kEof: a posição atual encontra-se no fim do ficheiro ou o ficheiro está vazio.
PerErrc::kPhysicalStorageFailure: o acesso ao armazenamento físico falhou.
PerErrc::kValidationFailed: a validade dos dados armazenados não pode ser garantida.
PerErrc::kEncryptionFailed: a desencriptação dos dados armazenados falhou.
PerErrc::kAuthenticationFailed: a verificação do MAC (Message Authentication Code) falhou.
No que diz respeito à segurança de execução, o método está declarado como noexcept e exception safe[SWS_PER_00418]. No entanto, como a especificação classifica PeekByte como not thread-safe, chamadas paralelas na mesma instância de ara::per::ReadAccessor necessitarão provavelmente de sincronização do lado da aplicação [SWS_PER_00418]. Pergunta Q-14b3334052f6c810 (aberta)
Esta nota de utilização foi gerada por uma IA com base na especificação AUTOSAR R25-11.
Returns the character at the current position of the file. The current position is not changed.
GERADO POR IAnão revisadoModelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: b4d92aee30b2Procedência
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão
O método PeekChar da classe ara::per::ReadAccessor (cabeçalho #include "ara/per/read_accessor.h") lê o caráter na posição atual de um ficheiro sem alterar o ponteiro de leitura [SWS_PER_00167].
usar
A função possui a assinatura ara::core::Result<char> PeekChar() const noexcept;. Opera sincronamente, está declarada como const e garante segurança contra exceções (exception safe) [SWS_PER_00167]. Como valor de retorno serve um ara::core::Result<char>, o qual, em caso de sucesso, contém o caráter lido [SWS_PER_00167].
Tratamento de erros
Se ocorrer um erro, o ara::core::Result devolve erros específicos do fabricante ou um dos seguintes códigos de erro de PerErrc[SWS_PER_00167]:
PerErrc::kEof: a posição de leitura atual atingiu o fim do ficheiro ou o ficheiro está vazio [SWS_PER_00167].
PerErrc::kPhysicalStorageFailure: o acesso ao suporte de armazenamento físico falhou [SWS_PER_00167].
PerErrc::kValidationFailed: a validade dos dados armazenados não pode ser garantida [SWS_PER_00167].
PerErrc::kEncryptionFailed: A descriptografia dos dados armazenados falhou [SWS_PER_00167].
PerErrc::kAuthenticationFailed: a verificação do Message Authentication Code (MAC) dos dados falhou [SWS_PER_00167].
Simultaneidade e restrições
A operação não é segura para threads (not thread-safe) [SWS_PER_00167]. Por conseguinte, acessos paralelos à mesma instância de ReadAccessor têm de ser sincronizados pelo chamador.
Esta nota de uso baseia-se na especificação AUTOSAR Adaptive Release R25-11.
Reads all remaining bytes into a Vector of Byte, starting from the current position. The current position is set to the end of the file. In case of an error, the current position is not changed.
GERADO POR IAnão revisadoModelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: 325f0e841208ProcedênciaPerguntas em aberto (1)
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão
O método sem parâmetros ReadBinary da classe ara::per::ReadAccessor lê sincronamente todos os bytes restantes a partir da posição atual do arquivo até o fim do arquivo para um ara::core::Vector<ara::core::Byte>[SWS_PER_00421]. Após uma operação de leitura bem-sucedida, a posição atual do arquivo é definida para o fim do arquivo [SWS_PER_00421]. O valor de retorno é encapsulado como ara::core::Result e declarado como noexcept; Interpretação: Como não há um tipo de retorno assíncrono, presume-se que o método bloqueie o chamador. Pergunta Q-8e6054123cea57ac (aberta)
Se ocorrer um erro durante a leitura, a posição original do arquivo é mantida inalterada [SWS_PER_00421]. O ara::core::Result retornado contém, neste caso, erros específicos do fornecedor ou um dos códigos de erro específicos de PerErrc[SWS_PER_00421]:
PerErrc::kPhysicalStorageFailure: O acesso à memória física falha [SWS_PER_00421].
PerErrc::kValidationFailed: A validade dos dados armazenados não pode ser assegurada [SWS_PER_00421].
PerErrc::kEncryptionFailed: A decodificação dos dados falha [SWS_PER_00421].
PerErrc::kAuthenticationFailed: A verificação do MAC falha [SWS_PER_00421].
PerErrc::kEof: O arquivo está vazio ou a posição de leitura já está no fim do arquivo [SWS_PER_00421].
A função é definida como segura contra exceções (exception safe), mas expressamente como não thread-safe (not thread-safe) [SWS_PER_00421]. Chamadas concorrentes no mesmo ReadAccessor devem, portanto, ser coordenadas pelo chamador. Se não se pretende ler todo o conteúdo restante do arquivo de uma só vez, mas apenas um subconjunto de bytes, deve ser usada, em vez disso, a variante sobrecarregada ReadBinary(std::uint64_t n)[SWS_PER_00422].
Este texto foi gerado por uma IA. Todas as informações são baseadas nos requisitos da especificação AUTOSAR.
Reads a number of bytes into a Vector of Byte, starting from the current position. The current position is advanced accordingly. If the end of the file is reached, the number of returned bytes can be less than the requested number, and the current position is set to the end of the file. In case of an error, the current position is not changed.
GERADO POR IAnão revisadoModelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: 4e14906b2550Procedência
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão
A função ReadBinary da classe ara::per::ReadAccessor lê sincronamente, a partir da posição atual do arquivo, até n bytes para um ara::core::Vector<ara::core::Byte>[SWS_PER_00422]. Em caso de leitura bem-sucedida, a posição atual do arquivo é avançada pelo número de bytes lidos; se o fim do arquivo for alcançado no processo, o vetor retornado pode conter menos de n bytes, e a posição do arquivo permanece no fim do arquivo [SWS_PER_00422].
Se ocorrer um erro durante a operação de leitura, a posição do arquivo não é alterada [SWS_PER_00422]. O tratamento de erros é feito através do ara::core::Result retornado, que pode conter códigos de erro específicos de PerErrc ou erros específicos do fornecedor [SWS_PER_00422]:
PerErrc::kPhysicalStorageFailure: O acesso à memória física falha [SWS_PER_00422].
PerErrc::kValidationFailed: A validação dos dados armazenados não pode ser assegurada [SWS_PER_00422].
PerErrc::kEncryptionFailed: A decodificação dos dados armazenados falha [SWS_PER_00422].
PerErrc::kEof: A posição atual já se encontra no final do arquivo ou o arquivo está vazio [SWS_PER_00422].
PerErrc::kAuthenticationFailed: A verificação do MAC (Message Authentication Code) dos dados falha [SWS_PER_00422].
Em relação à concorrência, o método é especificado como not thread-safe, razão pela qual acessos paralelos ao mesmo acessor devem ser sincronizados pelo lado da aplicação; no entanto, ele é declarado como exception safe e anotado com noexcept[SWS_PER_00422]. Diferentemente da sobrecarga sem parâmetros [SWS_PER_00421], que lê sempre todos os bytes restantes até o fim do arquivo, esta variante permite a leitura em partes de tamanhos de bloco definidos.
Este texto foi gerado por uma IA e serve como auxílio de curadoria.
Reads a complete line of characters into a String, advancing the current position accordingly. The end of the line is demarcated by the delimiter, or by "\\n" (ASCII 0x0a) if that parameter is omitted. The delimiter itself is not included in the returned String. Only Unicode code points with one character (code unit) can be used as delimiters. The returned string may start with an incomplete Unicode code point in case the current read position is in the middle of a code point. If the end of the file is reached, the remaining characters are returned and the current position is set to the end of the file. In case of an error, the current position is not changed.
GERADO POR IAnão revisadoModelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: 30f46bde066bProcedênciaPerguntas em aberto (1)
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão
usar
O método síncrono ReadLine da classe ara::per::ReadAccessor lê uma linha completa até a um delimitador especificado para uma ara::core::String e avança a posição de leitura em conformidade [SWS_PER_00119]. Por padrão, \n (ASCII 0x0a) atua como delimitador; como delimiter são permitidos exclusivamente code points Unicode que consistam numa única unidade de código [SWS_PER_00119]. O delimitador em si não está incluído na string de resultado. Se a operação de leitura atingir o fim do ficheiro, são devolvidos todos os carateres restantes até então e a posição é definida para o fim do ficheiro [SWS_PER_00119].
Tratamento de erros
A função devolve um ara::core::Result<ara::core::String>[SWS_PER_00119]. Se ocorrer um erro, a posição atual não é alterada [SWS_PER_00119]. Entre os erros especificados contam-se:
PerErrc::kEof: a posição de leitura atual encontra-se no fim do ficheiro ou o ficheiro está vazio [SWS_PER_00119].
StorageFailure: o acesso ao armazenamento físico falha [SWS_PER_00119].
PerErrc::kValidationFailed: A validade dos dados armazenados não pode ser assegurada [SWS_PER_00119].
PerErrc::kEncryptionFailed: A decodificação dos dados falha [SWS_PER_00119].
PerErrc::kAuthenticationFailed: a verificação do Message Authentication Code (MAC) falha [SWS_PER_00119].
Simultaneidade e condições marginais
O método está declarado como noexcept e seguro contra exceções («exception safe»), mas explicitamente não seguro para threads («not thread-safe») [SWS_PER_00119]. Interpretação: em chamadas concorrentes na mesma instância de ReadAccessor, será provavelmente necessária uma sincronização externa. Pergunta Q-307b6e250938c76b (aberta) Se a posição de leitura atual se encontrar no meio de um code point Unicode de várias partes, a cadeia de carateres devolvida pode começar com um code point incompleto [SWS_PER_00119].
Este texto foi criado por uma IA e baseia-se na especificação AUTOSAR.
Reads a number of characters into a String, starting from the current position. The returned string may start and/or end with incomplete Unicode code points in case the current read position and/or the last read character (code unit) is in the middle of a code point. The current position is advanced accordingly. If the end of the file is reached, the number of returned characters can be less than the requested number, and the current position is set to the end of the file. In case of an error, the current position is not changed.
GERADO POR IAnão revisadoModelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: 042205956a20Procedência
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão
A função-membro síncrona ReadText da classe ara::per::ReadAccessor lê, a partir da posição atual do arquivo, até n caracteres para uma ara::core::String[SWS_PER_00165]. A inclusão é feita através do cabeçalho #include "ara/per/read_accessor.h"[SWS_PER_00165].
Utilização e semântica
O método é chamado com o parâmetro std::uint64_t n e retorna um ara::core::Result<ara::core::String>[SWS_PER_00165]. Em caso de operação de leitura bem-sucedida, a posição atual de leitura avança de acordo com o número de caracteres lidos [SWS_PER_00165]. Se a operação de leitura atingir o final do arquivo, a quantidade de caracteres retornados pode ser menor que o n solicitado; a posição do arquivo é, nesse caso, ajustada para o final do arquivo [SWS_PER_00165]. Caso a posição de leitura atual ou o último caractere lido (unidade de código) esteja no meio de um codepoint Unicode, a string retornada pode iniciar ou terminar com codepoints incompletos [SWS_PER_00165].
Tratamento de erros e condições de contorno
Em caso de erro, a posição do arquivo permanece inalterada [SWS_PER_00165]. O ara::core::Result retornado pode conter erros específicos do fornecedor ou os seguintes códigos de erro [SWS_PER_00165]:
PerErrc::kPhysicalStorageFailure: O acesso físico ao armazenamento falhou [SWS_PER_00165].
PerErrc::kValidationFailed: A validade dos dados armazenados não pode ser garantida [SWS_PER_00165].
PerErrc::kEncryptionFailed: A descriptografia dos dados armazenados falhou [SWS_PER_00165].
PerErrc::kEof: A posição atual já se encontra no final do arquivo ou o arquivo está vazio [SWS_PER_00165].
PerErrc::kAuthenticationFailed: A verificação MAC dos dados falhou [SWS_PER_00165].
Em relação à concorrência, a função é declarada como segura contra exceções (exception safe), mas expressamente como não thread-safe (not thread-safe) [SWS_PER_00165]. Chamadas paralelas na mesma instância devem, consequentemente, ser sincronizadas.
Interação
Além da sobrecarga com limite de comprimento, existe uma variante sem parâmetros ReadText()[SWS_PER_00420], que lê, a partir da posição atual, todos os caracteres restantes até o final do arquivo.
Este texto foi criado e curado por uma IA. Todas as informações apoiam-se na especificação do release AUTOSAR R25-11.
Reads all remaining characters into a String, starting from the current position. The returned string may start with an incomplete Unicode code point in case the current read position is in the middle of a code point. The current position is set to the end of the file. In case of an error, the current position is not changed.
GERADO POR IAnão revisadoModelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: d5efea9a0341Procedência
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão
O método síncrono ReadText da classe ara::per::ReadAccessor lê todos os caracteres restantes a partir da posição atual do arquivo para um ara::core::String[SWS_PER_00420]. A função não espera parâmetros e, após uma leitura bem-sucedida, define a posição atual para o fim do arquivo [SWS_PER_00420]. Se a posição de leitura estiver no meio de um code point Unicode, a string retornada pode começar com um code point incompleto [SWS_PER_00420].
O valor de retorno é um ara::core::Result<ara::core::String>[SWS_PER_00420]. Se ocorrer um erro, a posição do arquivo permanece inalterada (semântica de rollback) e o resultado contém um erro específico do fornecedor ou um código de erro de PerErrc[SWS_PER_00420]:
PerErrc::kEof: A posição atual já está no fim do arquivo ou o arquivo está vazio [SWS_PER_00420].
PerErrc::kPhysicalStorageFailure: O acesso à memória física falha [SWS_PER_00420].
PerErrc::kValidationFailed: A validade dos dados armazenados não pode ser garantida [SWS_PER_00420].
PerErrc::kEncryptionFailed: A decodificação dos dados armazenados falha [SWS_PER_00420].
PerErrc::kAuthenticationFailed: A verificação do Message Authentication Code (MAC) falha [SWS_PER_00420].
Em relação à concorrência, ReadText é especificado como seguro contra exceções (exception safe) e declarado com noexcept, mas explicitamente classificado como não thread-safe [SWS_PER_00420].
Em conjunto com a sobrecarga relacionada ReadText(std::uint64_t n), que lê no máximo n caracteres e avança a posição de acordo [SWS_PER_00165], a variante sem parâmetros serve para a leitura completa de todo o conteúdo restante até o fim do arquivo [SWS_PER_00420].
Esta nota de uso foi criada de forma automatizada com base na especificação AUTOSAR R25-11.
gemini-3.8-flash-low· 2026-10-13 · Original em alemão