classe ara::core::BasicString

O operador de atribuição operator+= da classe ara::core::BasicString ([SWS_CORE_03072] de #include "ara/core/string.h") anexa o conteúdo de uma instância de BasicString passada de forma síncrona ao objeto atual. A semântica funcional segue o uso correspondente em [basic.string] ([SWS_CORE_03072]). A chamada retorna uma referência para a instância modificada (*this), o que viabiliza encadeamentos de atribuição.

Em relação ao tratamento de erros, a operação é explicitamente declarada na especificação como „not exception safe” ([SWS_CORE_03072]). Não estão definidos códigos de erro específicos ou mecanismos de notificação via DET ou DEM para este elemento. Caso uma alocação interna de memória falhe, o método, portanto, não oferece garantia de segurança contra exceções.

No que tange à concorrência e restrições, deve-se observar que a chamada modifica diretamente o estado da instância. Como o payload não menciona mecanismos de sincronização, o acesso concorrente de leitura ou escrita ao mesmo objeto através de múltiplas threads sem sincronização externa provavelmente não é seguro para threads. Pergunta Q-352f9d72ad3dfdbd (aberta)

O operador forma, juntamente com outras sobrecargas de operator+=, a interface para extensão de strings, por exemplo para caracteres individuais ([SWS_CORE_03074]), ponteiros de caracteres brutos ([SWS_CORE_03073]), listas de inicializadores ([SWS_CORE_03075]) bem como StringView ([SWS_CORE_03307]). Todos esses operadores de modificação compartilham a propriedade „not exception safe” e complementam os construtores fundamentais de ara::core::BasicString ([SWS_CORE_03024], [SWS_CORE_03025]).

usar

O operador de atribuição operator+= da classe ara::core::BasicString concatena sincronicamente uma cadeia de caracteres baseada em ponteiro à cadeia de caracteres existente e retorna uma referência ao objeto modificado [SWS_CORE_03073]. A função é incluída por meio do arquivo de cabeçalho #include "ara/core/string.h" e recebe como parâmetro um ponteiro s do tipo const value_type * [SWS_CORE_03073]. A semântica funcional segue a definição padronizada de [basic.string], tendo como principal divergência a substituição do tipo de caractere padrão charT por value_type [SWS_CORE_03073].

Tratamento de erros e restrições

Em relação à segurança contra exceções, a função membro é explicitamente declarada como não segura contra exceções ("not exception safe") [SWS_CORE_03073]. Códigos de erro específicos, valores de retorno para indicação de erro ou mensagens de erro para DET ou DEM não são especificados para este operador. Interpretação: em caso de falha em alocações de memória internas necessárias durante o aumento da cadeia de caracteres, presumivelmente nenhum estado consistente do objeto pode ser garantido e não existe canal de erro separado no ambiente AUTOSAR Adaptive. Pergunta Q-a1498ddbc09bcfa9 (aberta)

Interação

O método complementa os demais operadores de atribuição dentro de ara::core::BasicString, que realizam a anexação de instâncias completas de cadeias de caracteres [SWS_CORE_03072], caracteres individuais [SWS_CORE_03074], listas de inicializadores [SWS_CORE_03075] ou objetos StringView [SWS_CORE_03307]. Assim como os construtores para ponteiros brutos de caracteres [SWS_CORE_03028] [SWS_CORE_03029], todas essas variantes são especificadas como não seguras contra exceções.

A função membro operator+= da classe ara::core::BasicString possibilita a anexação síncrona de um único caractere c do tipo value_type ao objeto chamador de cadeia de caracteres [SWS_CORE_03074]. A declaração está contida no cabeçalho ara/core/string.h [SWS_CORE_03074]. O comportamento corresponde à especificação em [basic.string], com a divergência de que o tipo de parâmetro charT foi substituído por value_type [SWS_CORE_03074]. Como valor de retorno, é fornecida uma referência ao objeto modificado (BasicString &), o que suporta chamadas encadeadas.

Em relação à robustez e ao tratamento de erros, a operação é classificada como not exception safe [SWS_CORE_03074]. Códigos de erro específicos bem como mensagens para DET ou DEM não estão definidos para esta função. Interpretação: a classificação como não segura contra exceções presumivelmente baseia-se no fato de que, ao exceder a capacidade atual do buffer, deve ser disparada uma alocação dinâmica por meio do alocador subjacente, a qual pode falhar em caso de falta de memória. Pergunta Q-d74ec80829327ce0 (aberta)

Quanto à concorrência e condições de contorno, a função modifica a instância diretamente; acessos simultâneos de leitura ou escrita sem sincronização externa não são, portanto, seguros. Na interação com outras interfaces, o operador complementa a instanciação por meio de construtores como [SWS_CORE_03024] ou [SWS_CORE_03025] bem como atribuições compostas alternativas para cadeias de caracteres completas [SWS_CORE_03072], ponteiros de cadeias de caracteres [SWS_CORE_03073], listas de inicialização [SWS_CORE_03075] e exibições de string [SWS_CORE_03307].

A função membro operator+= de ara::core::BasicString ([SWS_CORE_03075]) concatena sincronicamente os caracteres de uma std::initializer_list<value_type> ao objeto de string existente. Como valor de retorno, o método fornece uma referência à cadeia de caracteres modificada (*this). O comportamento orienta-se pelo padrão C++ para [basic.string], sendo charT substituído por value_type ([SWS_CORE_03075]). Para a utilização, deve-se incluir o cabeçalho ara/core/string.h ([SWS_CORE_03075]).

No que diz respeito ao tratamento de erros e à robustez, a função é classificada como not exception safe ([SWS_CORE_03075]). Interpretação: é de presumir que, em caso de memória insuficiente durante uma realocação necessária, exceções possam ser lançadas sem que uma forte garantia de exceção seja assegurada para o conteúdo anterior do buffer. Pergunta Q-0f3d6328fb6bfd73 (aberta)

Quanto à concorrência e restrições, a chamada ocorre sincronicamente no contexto da thread chamadora. Como a instância chamada é modificada diretamente, o acesso simultâneo de múltiplas threads sem sincronização externa não é thread-safe.

Na interação com outras interfaces, esta sobrecarga complementa os outros operadores de concatenação de ara::core::BasicString, entre eles a anexação de strings ([SWS_CORE_03072]), arrays de caracteres ([SWS_CORE_03073]), caracteres individuais ([SWS_CORE_03074]) ou um StringView ([SWS_CORE_03307]). Além disso, a lista de inicialização corresponde semanticamente ao respectivo construtor ([SWS_CORE_03032]).

A função membro operator+= da classe ara::core::BasicString anexa uma sequência de caracteres passada por StringView sv sincronamente ao objeto de string chamador e retorna uma referência a este objeto modificado [SWS_CORE_03307]. A operação é definida por meio do arquivo de cabeçalho #include "ara/core/string.h", com o comportamento funcional seguindo as convenções gerais de [basic.string] [SWS_CORE_03307].

Tratamento de erros e simultaneidade

Em relação à execução, a função é classificada expressamente como not exception safe [SWS_CORE_03307]. Não são definidos códigos de erro específicos para DET ou DEM. Caso uma alocação de memória interna falhe durante o prolongamento da cadeia de caracteres, o estado interno da instância provavelmente não terá a garantia de permanecer inalterado. Devido à falta de mecanismos de sincronização integrados, deve-se presumir a ausência de segurança para threads em caso de acesso concorrente de escrita ou leitura por múltiplas threads à mesma instância (interpretação). Pergunta Q-1bed85bd42475f62 (aberta)

Interação

O operador integra-se perfeitamente à estrutura da classe ara::core::BasicString e complementa as sobrecargas alternativas de operator+= para strings completas [SWS_CORE_03072], ponteiros de caracteres const value_type* [SWS_CORE_03073], caracteres individuais [SWS_CORE_03074] e listas de inicialização [SWS_CORE_03075]. A criação das instâncias de string envolvidas ocorre por meio dos respectivos construtores da classe, como o construtor padrão [SWS_CORE_03024] ou construtores de cópia e de movimentação [SWS_CORE_03033], [SWS_CORE_03034].

usar

A função BasicString() do ficheiro de cabeçalho #include "ara/core/string.h" é o construtor padrão sem parâmetros da classe ara::core::BasicString ([SWS_CORE_03024]). A chamada ocorre de forma síncrona e, sendo um construtor, não fornece qualquer valor de retorno. O comportamento orienta-se pela definição correspondente em [basic.string] ([SWS_CORE_03024]); a instância criada deverá, portanto, representar uma cadeia de caracteres vazia. Pergunta Q-f36b11fa590a6111 (aberta)

Tratamento de erros e segurança contra exceções

O elemento está especificado como condicionalmente seguro contra exceções (conditionally exception safe) ([SWS_CORE_03024]). Segundo a especificação, não existem códigos de erro específicos, nem mensagens DET ou DEM. Através da assinatura BasicString () noexcept(noexcept(Allocator()));, a segurança contra exceções está diretamente vinculada ao construtor padrão do alocador ([SWS_CORE_03024]). Se a criação de Allocator() não lançar nenhuma exceção, a construção de BasicString comporta-se garantidamente sem exceções.

Interação e restrições

No contexto das restantes interfaces de ara::core::BasicString, são relevantes as seguintes dependências:

• Se for passado um alocador já instanciado, a assinatura garante segurança irrestrita contra exceções (exception safe / noexcept) ([SWS_CORE_03025]).
• Outras inicializações – por exemplo, através de subintervalos ([SWS_CORE_03026], [SWS_CORE_03027]), ponteiros ([SWS_CORE_03028], [SWS_CORE_03029]), sequências de carateres ([SWS_CORE_03030]), iteradores ([SWS_CORE_03031]), listas de inicialização ([SWS_CORE_03032]) ou operações de cópia e movimentação com alocador ([SWS_CORE_03033], [SWS_CORE_03034]) – são, em contrapartida, classificadas como not exception safe.
• A instância inicializada pode ser expandida sincronicamente, entre outros meios, por sobrecargas de operator+= para cadeias de caracteres ([SWS_CORE_03072]), ponteiros de carateres ([SWS_CORE_03073]), carateres individuais ([SWS_CORE_03074]), listas de inicialização ([SWS_CORE_03075]), bem como StringView ([SWS_CORE_03307]).
• Além disso, o objeto pode ser utilizado para a construção de um Bitset ([SWS_CORE_01749]).

O construtor explícito BasicString(const Allocator &a) do arquivo de cabeçalho #include "ara/core/string.h" inicializa uma instância vazia de ara::core::BasicString utilizando o alocador passado [SWS_CORE_03025]. O comportamento semântico orienta-se pela seção do padrão C++ [basic.string] [SWS_CORE_03025]. Por meio da palavra-chave explicit são impedidas conversões de tipo implícitas e não intencionais a partir de uma instância de alocador [SWS_CORE_03025].

Em relação ao tratamento de erros e tratamento de exceções, a função é declarada como noexcept e especificada como segura contra exceções (exception safe) [SWS_CORE_03025]. Diferentemente do construtor padrão [SWS_CORE_03024], cuja segurança contra exceções depende condicionalmente de noexcept(noexcept(Allocator())), esta chamada sempre garante uma criação livre de erros e sem exceções [SWS_CORE_03025], [SWS_CORE_03024]. Interpretação: a segurança incondicional contra exceções provavelmente baseia-se no fato de que, na inicialização de uma cadeia de caracteres vazia, não precisam ser executadas etapas de alocação que consomem muita memória. Pergunta Q-88df57e7a9c2abda (aberta)

Na interação com outros construtores da classe, como [SWS_CORE_03026] ou [SWS_CORE_03028], que copiam dados e são classificados como não seguros contra exceções (not exception safe), este construtor serve como ponto de entrada seguro. A cadeia de caracteres criada pode ser subsequentemente expandida de forma dinâmica através de modificadores como operator+= ([SWS_CORE_03072], [SWS_CORE_03307]) ou usada como entrada para tipos como Bitset [SWS_CORE_01749].

usar

A função Basic representa um construtor da classe ara::core::BasicString, fornecido por meio do arquivo de cabeçalho #include "ara/core/string.h" [SWS_CORE_03026]. Ele gera sincronamente uma nova cadeia de caracteres como substring a partir do objeto de origem str a partir da posição de índice pos de acordo com a semântica de [basic.string] [SWS_CORE_03026]. Durante isso, os seguintes parâmetros são processados:

• str: Referência à instância de origem a ser copiada do tipo BasicString [SWS_CORE_03026].
• pos: Posição inicial baseada em zero da substring do tipo size_type [SWS_CORE_03026].
• a: Alocador para gerenciamento de memória, configurado por padrão com Allocator() [SWS_CORE_03026].

Tratamento de erros e segurança contra exceções

Para a função, a propriedade not exception safe é definida na especificação [SWS_CORE_03026]. Não são definidos códigos de erro específicos nem mensagens de DET ou DEM. Interpretação: Como o construtor segue o comportamento padrão de [basic.string] e não garante segurança contra exceções, valores de índice inválidos para pos, bem como falhas na alocação de memória, devem levar ao lançamento de exceções [SWS_CORE_03026]. Pergunta Q-7ea120ac992dc5ac (aberta)

Interação e requisitos relacionados

Dentro de ara::core::BasicString, este construtor complementa a variante com limitação adicional de comprimento n [SWS_CORE_03027], bem como sobrecargas para ponteiros, iteradores e listas de inicialização [SWS_CORE_03028], [SWS_CORE_03031], [SWS_CORE_03032]. Diferentemente dos construtores sem cadeia de caracteres de origem, que são condicionalmente seguros contra exceções [SWS_CORE_03024] ou declarados como noexcept [SWS_CORE_03025], a adoção dinâmica de substrings requer atenção especial a possíveis falhas de alocação. Além disso, BasicString serve como base de parâmetros em outros blocos funcionais do módulo, como Bitset [SWS_CORE_01749].

O construtor [SWS_CORE_03027] da classe ara::core::BasicString destina-se à criação síncrona de uma nova cadeia de caracteres como subsequência a partir de uma cadeia de caracteres de origem str. A partir do índice pos, são aproveitados até n caracteres. Por meio do parâmetro opcional a, pode ser passado um alocador personalizado; caso contrário, uma instância de alocador padrão é criada por padrão. A definição é fornecida por meio do cabeçalho #include "ara/core/string.h".

Em relação à robustez, a função é declarada como not exception safe ([SWS_CORE_03027]). Conforme a especificação segundo [basic.string], este construtor deverá falhar caso pos ultrapasse o comprimento da cadeia de caracteres inicial ou a alocação do novo buffer falhe. Pergunta Q-31041ea019720daf (aberta) Isso contrasta com construtores padrão e de alocador como [SWS_CORE_03024] e [SWS_CORE_03025], que são especificados como condicionalmente seguros contra exceções ou explicitamente com noexcept.

Na interação dentro de ara::core::BasicString, a função complementa sobrecargas alternativas: enquanto [SWS_CORE_03026] copia a substring a partir de pos até o final da string, [SWS_CORE_03027] permite a limitação explícita do comprimento. Outras alternativas para criação oferecem inicializações baseadas em iteradores ([SWS_CORE_03031]) ou baseadas em ponteiros ([SWS_CORE_03028]). Além disso, o mesmo padrão de substring com pos e n também é utilizado em classes correlatas como Bitset em [SWS_CORE_01749].

A função construtora da classe ara::core::BasicString do cabeçalho ara/core/string.h cria sincronamente uma cadeia de caracteres a partir de um ponteiro s para um array de caracteres e de uma especificação de comprimento explícita n [SWS_CORE_03028]. Através do parâmetro a, pode ser passado opcionalmente um alocador personalizado, que por padrão recorre a Allocator() [SWS_CORE_03028]. A semântica corresponde à definição em [basic.string], sendo o tipo de parâmetro charT substituído por value_type de forma divergente [SWS_CORE_03028].

Na especificação, a função está identificada como não segura contra exceções (not exception safe) [SWS_CORE_03028]. Isso a diferencia de inicializações seguras contra exceções, como o construtor com alocador [SWS_CORE_03025] ou o construtor padrão condicionalmente seguro contra exceções [SWS_CORE_03024]. Não estão previstos códigos de erro específicos, valores de retorno ou mensagens de diagnóstico para DEM ou DET. Como pré-condição essencial, o chamador provavelmente terá de assegurar que s aponte para uma área de memória válida com pelo menos n elementos contíguos (interpretação), a fim de excluir comportamento indefinido. Pergunta Q-957a57c885a2e702 (aberta)

Dentro da classe ara::core::BasicString, esta sobrecarga complementa a construção sem indicação de comprimento para cadeias de caracteres terminadas em nulo [SWS_CORE_03029], bem como construtores para sequências de caracteres idênticos [SWS_CORE_03030] ou substrings [SWS_CORE_03027]. Após a criação, o objeto pode ser modificado por operadores de atribuição e concatenação [SWS_CORE_03072]. Além disso, a cadeia de caracteres resultante serve como entrada para interfaces de tipos de dados relacionados, por exemplo para a inicialização de um Bitset [SWS_CORE_01749].

O construtor [SWS_CORE_03029] inicializa uma instância de ara::core::BasicString a partir de um ponteiro terminado em nulo para cadeias de caracteres do tipo const value_type* e de um alocador opcional. A sua semântica segue a definição padrão de [basic.string], em que charT é substituído por value_type [SWS_CORE_03029]. O arquivo de cabeçalho é #include "ara/core/string.h" [SWS_CORE_03029].

Em relação ao comportamento de falha e à segurança contra exceções, a função é especificada explicitamente como not exception safe [SWS_CORE_03029]. Se ocorrer uma alocação de memória ou um erro durante a construção, nenhuma garantia de exceção é assegurada. Em contrapartida, construtores padrão como [SWS_CORE_03025] são classificados como noexcept e exception safe ou [SWS_CORE_03024] como condicionalmente seguros contra exceções (conditionally exception safe).

A especificação define a interação dentro da família de construtores de BasicString:

• Se a contagem de caracteres for especificada explicitamente, deve-se recorrer à sobrecarga com parâmetro de comprimento (const value_type *s, size_type n, ...) de acordo com [SWS_CORE_03028].
• Outras alternativas incluem construtores de subfaixa a partir de strings existentes [SWS_CORE_03026], [SWS_CORE_03027], construtores de preenchimento [SWS_CORE_03030] bem como listas de iteradores [SWS_CORE_03031] e de inicializadores [SWS_CORE_03032].
• Para a concatenação posterior com ponteiros de cadeias de caracteres brutos, corresponde operator+= de acordo com [SWS_CORE_03073].
• Além disso, BasicString serve como base de parâmetros em outras classes auxiliares como Bitset de acordo com [SWS_CORE_01749].

Os chamadores devem garantir que o ponteiro s seja válido e devidamente terminado em nulo (interpretação: uma vez que, sem especificação de comprimento, a terminação serve para a determinação do comprimento conforme o comportamento padrão). Pergunta Q-7e0172674e115dea (aberta) Como o construtor é executado sincronicamente, em contextos críticos para a segurança deve-se levar em consideração que memória potencialmente dinâmica é obtida por meio do alocador.

usar

O construtor [SWS_CORE_03030] da classe ara::core::BasicString (definido no cabeçalho ara/core/string.h) cria sincronicamente uma cadeia de caracteres a partir de n cópias do caractere c do tipo value_type. O comportamento funcional segue a especificação padrão do C++ [basic.string] com a diferença de que charT é substituído por value_type. Opcionalmente, pode ser passado um alocador definido pelo utilizador a, para o qual Allocator() é instanciado por defeito.

Tratamento de erros e segurança de exceções

A especificação classifica este construtor como not exception safe, distinguindo-se assim de construtores com noexcept garantido, como [SWS_CORE_03025], ou do construtor por defeito condicionalmente seguro [SWS_CORE_03024]. Interpretação: A ausência de segurança contra exceções deve-se provavelmente, sobretudo, a falhas na alocação dinâmica de memória para n caracteres. Pergunta Q-87ae8b5cae690fdb (aberta) Códigos de erro AUTOSAR específicos ou mensagens para o DET ou DEM não estão especificados para esta chamada.

Concorrência e interação

Acessos simultâneos de múltiplas threads à mesma instância sem sincronização externa não são thread-safe. Após a criação, a cadeia de caracteres pode ser modificada através de operadores de concatenação, como operator+= para caracteres individuais ([SWS_CORE_03074]) ou strings ([SWS_CORE_03072]). A cadeia de caracteres criada pode ainda servir para a inicialização de ara::core::Bitset de acordo com [SWS_CORE_01749]. Para formas alternativas de criação, estão disponíveis construtores através de ponteiros ([SWS_CORE_03028], [SWS_CORE_03029]) ou listas de inicialização ([SWS_CORE_03032]).

usar

A função de template representa o construtor de intervalo da classe ara::core::BasicString no cabeçalho <ara/core/string.h> [SWS_CORE_03031]. Ela serve para a inicialização síncrona de uma cadeia de caracteres a partir de uma sequência definida pelos iteradores de entrada begin e end do tipo InputIterator [SWS_CORE_03031]. Opcionalmente, pode ser passada uma instância de alocador definida pelo usuário por meio do parâmetro a; se este parâmetro permanecer não preenchido, a instância padrão Allocator() é criada [SWS_CORE_03031]. A semântica funcional segue as especificações do padrão C++ para [basic.string] [SWS_CORE_03031].

Tratamento de erros e segurança de exceções

A especificação declara a função explicitamente como not exception safe [SWS_CORE_03031]. Nenhuma mensagem DET ou DEM específica do AUTOSAR é emitida, uma vez que o comportamento corresponde àquele da biblioteca padrão do C++ [SWS_CORE_03031]. Interpretação: a ausência de segurança contra exceções presumivelmente deve-se a possíveis erros de alocação de memória pelo alocador ou a falhas nas operações dos iteradores passados. Pergunta Q-676411ee17d37217 (aberta)

Simultaneidade e restrições

A chamada ocorre sincronicamente no contexto da thread chamadora. Ao contrário do construtor padrão [SWS_CORE_03024] ou do construtor puramente com alocador [SWS_CORE_03025], este construtor não é declarado como noexcept. Os chamadores devem, portanto, assegurar que o intervalo [begin, end) seja válido e que os elementos referenciados possam ser lidos sem erros.

Interação

A função complementa os construtores alternativos de ara::core::BasicString, incluindo sobrecargas de substring [SWS_CORE_03026], de array de caracteres [SWS_CORE_03028] e de initializer list [SWS_CORE_03032], as quais apresentam a mesma classificação de exceção. Após a construção, a instância pode ser modificada por meio de operadores de concatenação como operator+= [SWS_CORE_03072] ou servir para a inicialização de tipos dependentes como Bitset [SWS_CORE_01749].

O construtor BasicString serve para a inicialização síncrona de uma instância de ara::core::BasicString com base numa lista de inicialização ([SWS_CORE_03032]). A declaração ocorre através do ficheiro de cabeçalho #include "ara/core/string.h" no âmbito da classe ara::core::BasicString ([SWS_CORE_03032]). O comportamento segue a definição em [basic.string], sendo charT substituído por value_type em conformidade com a norma ([SWS_CORE_03032]). São passados como parâmetros uma std::initializer_list<value_type> e, opcionalmente, um alocador ([SWS_CORE_03032]).

No que diz respeito ao tratamento de erros e de exceções, o construtor é especificado como not exception safe ([SWS_CORE_03032]). Isto distingue-o do construtor padrão ([SWS_CORE_03024]) ou do construtor de alocador explícito ([SWS_CORE_03025]), que estão declarados como seguros contra exceções ou noexcept. Códigos de erro específicos do AUTOSAR, mensagens do DET ou do DEM não estão definidos para este construtor. Interpretação: em caso de memória insuficiente, presume-se que a criação do objeto falhe, uma vez que é necessário alocar memória dinâmica para os elementos da lista de inicialização. Pergunta Q-7ecc7431c1c2f54c (aberta)

Na interação com o módulo core, a função complementa formas de construção alternativas, como a criação a partir de substrings ([SWS_CORE_03026], [SWS_CORE_03027]), ponteiros ([SWS_CORE_03028], [SWS_CORE_03029]) ou iteradores ([SWS_CORE_03031]). Para a extensão posterior de uma string existente com uma lista de inicialização, está disponível o operator+= correspondente ([SWS_CORE_03075]). Além disso, as instâncias de BasicString criadas podem ser utilizadas para a inicialização de tipos de dados relacionados, como Bitset ([SWS_CORE_01749]).

O construtor de cópia [SWS_CORE_03033] da classe ara::core::BasicString serve para a criação síncrona de uma nova cadeia de caracteres como cópia de uma instância existente sob passagem explícita de um alocador. A declaração da função BasicString (const BasicString &, const Allocator &); é disponibilizada através do cabeçalho #include "ara/core/string.h" [SWS_CORE_03033]. A semântica funcional orienta-se pela respetiva utilização no padrão de referência [basic.string] [SWS_CORE_03033].

No que diz respeito ao tratamento de erros, a função construtora está explicitamente classificada na especificação como not exception safe [SWS_CORE_03033]. Não existem códigos de erro AUTOSAR específicos nem notificações para módulos de diagnóstico como DET ou DEM para esta chamada; exceções na alocação dinâmica de memória pelo alocador deverão, portanto, estar sujeitas ao comportamento geral de [basic.string]. Pergunta Q-496b847c39fc25ae (aberta)

Relativamente à concorrência e condições-limite, a passagem da instância de origem por const BasicString & exige que o objeto de origem não seja modificado simultaneamente durante o processo de cópia. Acessos de leitura simultâneos a partir de múltiplas threads são permitidos, ao passo que acessos de escrita paralelos não protegidos conduzem presumivelmente a inconsistências de dados. Pergunta Q-daa5ef2c4672b657 (aberta)

Na interação com elementos de especificação relacionados, o construtor posiciona-se a par de caminhos de inicialização alternativos, como o construtor de movimento com alocador [SWS_CORE_03034], o construtor por defeito [SWS_CORE_03024] ou o construtor com alocador [SWS_CORE_03025]. O objeto criado pode ser modificado de forma integrada através de operadores como operator+= [SWS_CORE_03072] ou utilizado para a inicialização de tipos dependentes como Bitset [SWS_CORE_01749].

O construtor de movimento [SWS_CORE_03034] da classe ara::core::BasicString é disponibilizado através do ficheiro de cabeçalho #include "ara/core/string.h". Cria sincronicamente uma nova cadeia de caracteres assumindo os dados de uma instância existente e vinculando-os a um alocador explicitamente especificado. O comportamento semântico e os requisitos correspondem às determinações da norma ISO C++ em [basic.string].

No contexto da chamada, a função exige dois parâmetros: uma referência rvalue para um objeto de origem (BasicString&&), bem como uma instância de alocador (const Allocator&). O objeto de origem permanece num estado válido, mas alterado, após a operação de movimentação. No que diz respeito ao tratamento de erros, a função é classificada em [SWS_CORE_03034] como not exception safe. Interpretação: Isto dever-se-á ao facto de que, com um alocador divergente ou incompatível, é necessário alocar nova memória e copiar os elementos, o que pode falhar em situações de escassez de memória. Isto distingue o construtor de sobrecargas estritamente seguras contra exceções, como [SWS_CORE_03025], ou de variantes condicionalmente seguras contra exceções, como [SWS_CORE_03024]. Pergunta Q-2a89ad749ae1b2f6 (aberta)

Na interação dentro de core, a assinatura complementa o leque de métodos de criação a par do construtor de cópia com alocador [SWS_CORE_03033] e inicializadores de subcadeias como [SWS_CORE_03026]. Após instanciação bem-sucedida, a cadeia de caracteres pode ser modificada, por exemplo através da anexação de conteúdos via operator+= ([SWS_CORE_03072], [SWS_CORE_03307]), ou servir de entrada para tipos de dados dependentes como Bitset de acordo com [SWS_CORE_01749].

Utilização e semântica

A função de membro append da classe ara::core::BasicString ([SWS_CORE_03076]) do arquivo de cabeçalho #include "ara/core/string.h" destina-se à concatenação síncrona de um objeto de cadeia de caracteres completo str do tipo BasicString à instância chamadora. A semântica segue a definição C++ padronizada sob [basic.string]; como valor de retorno, a função fornece uma referência ao objeto modificado (*this) ([SWS_CORE_03076]).

Tratamento de erros e condições de contorno

Em relação à segurança contra exceções, a operação é explicitamente classificada como not exception safe ([SWS_CORE_03076]). Interpretação: Caso ocorra um erro durante a execução (por exemplo, em caso de memória insuficiente), o estado da cadeia de caracteres deverá ser indeterminado, uma vez que não estão especificadas garantias de recuperação. Ao contrário de variantes com índices de posição como [SWS_CORE_03077] ou [SWS_CORE_03309] (desencadeamento de IsoStdOutOfRangeViolation) ou verificações de tamanho de buffer como [SWS_CORE_03078] (desencadeamento de IsoStdLengthErrorViolation), [SWS_CORE_03076] não define violações à parte. Pergunta Q-57504af4ee633d0b (aberta)

Interação e sobrecargas

A função faz parte de uma família de sobrecargas dentro de ara::core::BasicString:

• Concatenação de substrings através de indicações de posição e comprimento ([SWS_CORE_03077]).
• Aceitação de arrays de caracteres do tipo value_type* com comprimento definido ([SWS_CORE_03078]) ou como cadeia de caracteres terminada em nulo ([SWS_CORE_03079]).
• Anexação múltipla de caracteres individuais ([SWS_CORE_03080]) ou atribuição através de std::initializer_list<value_type> ([SWS_CORE_03082]).
• Integração de intervalos de iteradores ([SWS_CORE_03081]), bem como visualizações de cadeia de caracteres por meio de StringView ([SWS_CORE_03308]) e templates específicos de tipo ([SWS_CORE_03309]).

A função membro append da classe ara::core::BasicString ([SWS_CORE_03077], declarada em #include "ara/core/string.h") anexa de forma síncrona uma substring de outra instância de BasicString str ao objeto atual. Os parâmetros pos e n (por padrão npos) determinam o índice inicial e o número máximo de caracteres dentro de str. Como valor de retorno, é fornecida uma referência ao objeto de destino modificado (*this).

Em relação à semântica e ao comportamento da interface, a função segue a definição em [basic.string] do padrão C++, mas difere no tratamento de erros: se pos > str.size() se aplicar, uma IsoStdOutOfRangeViolation será disparada de acordo com [SWS_CORE_03077] (análogo a std::out_of_range). A especificação classifica expressamente a operação como not exception safe, razão pela qual, em caso de erro, não há garantia sobre um estado inalterado ou consistente do objeto.

Na ausência de mecanismos de sincronização documentados, uma chamada concorrente na mesma instância provavelmente não é segura para threads. Pergunta Q-ec3b029fca94ad8a (aberta) Para fontes de dados alternativas, outras sobrecargas estão disponíveis no módulo: cadeias de caracteres completas ([SWS_CORE_03076]), buffers e ponteiros ([SWS_CORE_03078], [SWS_CORE_03079]), repetições de caracteres ([SWS_CORE_03080]), pares de iteradores ([SWS_CORE_03081]), listas de inicializadores ([SWS_CORE_03082]), bem como objetos StringView ([SWS_CORE_03308], [SWS_CORE_03309]).

A função de membro append da classe ara::core::BasicString ([SWS_CORE_03078]) anexa sincronamente os primeiros n caracteres do campo de caracteres transmitido s do tipo const value_type* à string existente. Como valor de retorno, a função fornece uma referência à instância modificada (BasicString&), o que permite o encadeamento de chamadas sucessivas. A declaração está disponível através do arquivo de cabeçalho #include "ara/core/string.h".

O comportamento funcional segue a especificação de std::basic_string::append de acordo com [basic.string], mas apresenta divergências AUTOSAR específicas ([SWS_CORE_03078]):

• O parâmetro de template charT é substituído pelo tipo value_type.
• Se o comprimento resultante exceder o limite de capacidade (condição size() > n + max_size()), é desencadeada a violação IsoStdLengthErrorViolation em vez de uma std::length_error.

Em relação à segurança de execução, a operação está explicitamente especificada como not exception safe ([SWS_CORE_03078]). Se ocorrer um erro ou violação durante a alocação de memória ou durante a cópia, o objeto não garante um estado intermediário consistente.

O método complementa as demais sobrecargas de append dentro de ara::core::BasicString. Entre elas estão a concatenação de instâncias completas ([SWS_CORE_03076]), de substrings com verificação de limites via IsoStdOutOfRangeViolation ([SWS_CORE_03077]), cadeias de caracteres terminadas em nulo ([SWS_CORE_03079]), sequências de caracteres idênticos ([SWS_CORE_03080]), intervalos de iteradores ([SWS_CORE_03081]), listas de inicialização ([SWS_CORE_03082]), bem como objetos StringView ([SWS_CORE_03308], [SWS_CORE_03309]).

A função membro append da classe ara::core::BasicString ([SWS_CORE_03079]) anexa uma cadeia de caracteres terminada em nulo do tipo de ponteiro const value_type* à cadeia de caracteres existente. A semântica corresponde ao comportamento do padrão C++ [basic.string], onde charT é substituído por value_type. Como valor de retorno, a função síncrona fornece uma referência ao objeto chamador (BasicString&), o que permite o encadeamento de operações consecutivas.

Quanto ao tratamento de erros e à segurança contra exceções, a operação é explicitamente classificada como not exception safe ([SWS_CORE_03079]). Em contraste com a sobrecarga com especificação de comprimento [SWS_CORE_03078], que dispara uma IsoStdLengthErrorViolation ao exceder o comprimento máximo, ou sobrecargas de substring como [SWS_CORE_03077] com IsoStdOutOfRangeViolation, esta variante não define classes de violação específicas. Deve ser de responsabilidade do chamador garantir que o ponteiro fornecido s aponte para uma sequência de caracteres válida e terminada em nulo. Pergunta Q-4e959f75f98977eb (aberta)

A função faz parte de uma família de sobrecargas para anexar dados em ara::core::BasicString:

• Anexação de cadeias de caracteres completas ou parciais do mesmo tipo ([SWS_CORE_03076], [SWS_CORE_03077]),
• Anexação de prefixos de ponteiro com limite explícito de comprimento ([SWS_CORE_03078]),
• Anexação de repetições de caracteres ([SWS_CORE_03080]) ou listas de inicialização ([SWS_CORE_03082]),
• Processamento de intervalos de iteradores ([SWS_CORE_03081]), bem como string views ([SWS_CORE_03308], [SWS_CORE_03309]).

A função membro append de ara::core::BasicString ([SWS_CORE_03080]) anexa uma quantidade especificada n de caracteres do tipo value_type (parâmetro c) sincronamente à cadeia de caracteres existente. Ela é fornecida por meio do cabeçalho ara/core/string.h e retorna uma referência à instância modificada (*this), permitindo chamadas encadeadas.

O comportamento funcional segue a definição do padrão C++ para [basic.string], onde charT é substituído por value_type ([SWS_CORE_03080]). Quanto à segurança contra exceções, a função é classificada explicitamente como not exception safe ([SWS_CORE_03080]). Ao contrário de outras sobrecargas como [SWS_CORE_03077] ou [SWS_CORE_03078], nenhuma violação de tempo de execução específica (violations) como IsoStdOutOfRangeViolation ou IsoStdLengthErrorViolation é definida para esta variante. Supostamente, o método não garante um estado inalterado da instância em caso de erro. Pergunta Q-15af6c12a1a342a9 (aberta)

No contexto de concorrência e segurança de threads, deve-se observar que acessos simultâneos de escrita na mesma instância de BasicString presumivelmente devem ser sincronizados externamente. Pergunta Q-1e8a1511516e4cd8 (aberta) A função complementa as outras sobrecargas de append em ara::core::BasicString, que abrangem a anexação de cadeias de caracteres completas ([SWS_CORE_03076]), de partes ([SWS_CORE_03077]), buffers de ponteiro ([SWS_CORE_03078], [SWS_CORE_03079]), intervalos de iterador ([SWS_CORE_03081]), listas de inicialização ([SWS_CORE_03082]) ou objetos StringView ([SWS_CORE_03308], [SWS_CORE_03309]).

Utilização e semântica

A função membro template append da classe ara::core::BasicString é disponibilizada por meio do arquivo de cabeçalho ara/core/string.h [SWS_CORE_03081]. Ela anexa uma sequência de caracteres, delimitada pelo par de iteradores first e last da categoria InputIterator, de forma síncrona à cadeia de caracteres existente [SWS_CORE_03081]. O comportamento funcional segue a respectiva definição em [basic.string] do padrão C++ [SWS_CORE_03081]. Como valor de retorno, a operação fornece uma referência ao objeto BasicString modificado (*this) [SWS_CORE_03081].

Tratamento de erros e segurança contra exceções

Para esta função, a segurança contra exceções é definida explicitamente como not exception safe [SWS_CORE_03081]. Em caso de erro – por exemplo, na exaustão da memória dinâmica durante o redimensionamento do buffer – a instância presumivelmente permanece em um estado inválido, de acordo com a interpretação. AUTOSAR violations específicas como IsoStdOutOfRangeViolation ou IsoStdLengthErrorViolation não são definidas para esta sobrecarga de iteradores, ao contrário de outras sobrecargas do método [SWS_CORE_03077], [SWS_CORE_03078]. Pergunta Q-600c7dacc868877c (aberta)

Interação no módulo

A função faz parte de um grupo abrangente de sobrecargas para anexar dados a ara::core::BasicString:

• Anexação de cadeias de caracteres completas ou parciais do tipo BasicString [SWS_CORE_03076], [SWS_CORE_03077].
• Anexação de arrays de caracteres com especificação de comprimento ou sequências de caracteres terminadas em nulo [SWS_CORE_03078], [SWS_CORE_03079].
• Anexação repetida de caracteres individuais [SWS_CORE_03080], bem como adoção a partir de std::initializer_list [SWS_CORE_03082].
• Integração de string views modernas por meio de StringView ou tipos genéricos de view [SWS_CORE_03308], [SWS_CORE_03309].

A variante com iterador [SWS_CORE_03081] oferece, assim, a flexibilidade máxima para a integração de fontes de dados genéricas quaisquer.

A função membro append da classe ara::core::BasicString anexa os caracteres de uma lista de inicialização do tipo std::initializer_list<value_type> sincronamente ao objeto de string existente [SWS_CORE_03082]. O comportamento segue a semântica de [basic.string] do padrão C++ com a diferença de que charT é substituído por value_type [SWS_CORE_03082]. A chamada modifica a instância diretamente e retorna uma referência ao objeto, permitindo encadeamento de métodos.

Quanto ao tratamento de erros, a função é classificada como não segura contra exceções (not exception safe) [SWS_CORE_03082]. Diferentemente de sobrecargas relacionadas como [SWS_CORE_03077] ou [SWS_CORE_03078], esta variante não define violações específicas como IsoStdOutOfRangeViolation ou IsoStdLengthErrorViolation. Interpretação: Se a alocação de memória interna falhar, o objeto provavelmente permanecerá em um estado indefinido. Pergunta Q-169750518dc1904b (aberta) Como o estado interno é alterado, uma chamada concorrente sem sincronização externa provavelmente levará a condições de corrida de dados.

Na interação dentro de ara::core::BasicString, a função faz parte de um grupo de operações relacionadas de append. Ela complementa sobrecargas para cadeias de caracteres completas ([SWS_CORE_03076]), partes ([SWS_CORE_03077]), ponteiros para cadeias de caracteres ([SWS_CORE_03078], [SWS_CORE_03079]), caracteres individuais repetidos ([SWS_CORE_03080]), intervalos de iterador ([SWS_CORE_03081]) e instâncias de StringView ([SWS_CORE_03308], [SWS_CORE_03309]).

usar

A função de membro síncrona append da classe ara::core::BasicString concatena os caracteres de uma visualização de cadeia de caracteres transmitida (StringView sv) à cadeia de caracteres existente [SWS_CORE_03308]. A interface é incluída através do cabeçalho #include "ara/core/string.h" [SWS_CORE_03308]. Ela retorna uma referência à instância chamadora (BasicString &), o que permite o encadeamento de múltiplas modificações [SWS_CORE_03308]. A semântica funcional segue a especificação correspondente em C++ [basic.string] [SWS_CORE_03308].

Tratamento de erros e segurança de exceções

A função está explicitamente especificada no AUTOSAR como não segura contra exceções («not exception safe») [SWS_CORE_03308]. Códigos de erro específicos, mensagens DET ou DEM, bem como violações AUTOSAR explícitas, não estão estabelecidos para esta chamada, ao passo que sobrecargas relacionadas, como [SWS_CORE_03077] ou [SWS_CORE_03309], desencadeiam uma IsoStdOutOfRangeViolation em ultrapassagens de índice e [SWS_CORE_03078] desencadeia uma IsoStdLengthErrorViolation em ultrapassagens de comprimento.

Concorrência e interação

Como append altera diretamente o estado do objeto string chamado, um acesso concorrente de múltiplas threads à mesma instância sem sincronização externa não deverá ser thread-safe. Pergunta Q-814665e285846c8e (aberta) O método integra um conjunto com outras variantes append de ara::core::BasicString, as quais possibilitam a concatenação de instâncias completas de BasicString [SWS_CORE_03076], C-strings [SWS_CORE_03079], caracteres individuais repetidos [SWS_CORE_03080], bem como intervalos de iteradores [SWS_CORE_03081] ou listas de inicialização [SWS_CORE_03082].

usar

A função template append da classe ara::core::BasicString ([SWS_CORE_03309]) do arquivo de cabeçalho #include "ara/core/string.h" serve para anexar sincronamente uma parte de um objeto t à cadeia de caracteres chamadora. O comportamento orienta-se pela especificação ISO C++ [basic.string]. O parâmetro pos define o índice inicial no objeto de origem, enquanto n determina a quantidade máxima de caracteres a serem anexados (valor padrão npos). Como valor de retorno, é fornecida uma referência ao objeto de cadeia de caracteres modificado (*this). Interpretação: O objeto passado t provavelmente é interpretado internamente como string view sv. Pergunta Q-9752a5eeaf05b684 (aberta)

Tratamento de erros

O AUTOSAR define para esta função um desvio específico em relação ao padrão C++: se a posição especificada for maior do que o tamanho do intervalo de origem (pos > sv.size()), uma IsoStdOutOfRangeViolation será disparada em vez de std::out_of_range ([SWS_CORE_03309]). A descrição semântica dessa violação corresponde à de std::out_of_range.

Restrições e segurança contra exceções

A operação é expressamente classificada na especificação como not exception safe ([SWS_CORE_03309]). Portanto, no caso de ocorrência de erros, nenhuma manutenção estável do estado anterior é garantida.

Interação

A função complementa as outras variantes para extensão de cadeias de caracteres em ara::core::BasicString. Entre elas estão sobrecargas para instâncias completas de BasicString ([SWS_CORE_03076]) ou suas partes ([SWS_CORE_03077]), cadeias de caracteres no estilo C com especificação de comprimento ([SWS_CORE_03078]) ou como ponteiros terminados em nulo ([SWS_CORE_03079]), repetições de caracteres ([SWS_CORE_03080]), intervalos de iterador ([SWS_CORE_03081]), listas de inicialização ([SWS_CORE_03082]), bem como objetos StringView separados ([SWS_CORE_03308]).

A função de membro assign da classe ara::core::BasicString serve para atribuir sincronamente o conteúdo de uma cadeia de caracteres existente à instância chamadora, de acordo com o comportamento de [basic.string] [SWS_CORE_03084]. A função é disponibilizada através do cabeçalho ara/core/string.h e aceita uma referência constante a um objeto BasicString (const BasicString &str). Como valor de retorno, ela fornece uma referência ao objeto de destino modificado (*this), o que permite encadeamentos de métodos [SWS_CORE_03084].

Em relação à robustez, a função é explicitamente especificada como not exception safe [SWS_CORE_03084]. Em alocações dinâmicas de memória durante o processo de cópia, podem ocorrer erros que não são interceptados por garantias de exceção; em caso de erro, a instância provavelmente permanecerá em um estado indefinido. Pergunta Q-0ddd5ac03e56490f (aberta) Códigos de erro AUTOSAR específicos ou mensagens para DET ou DEM não estão previstos para esta função de atribuição.

Na interação com outras interfaces, assign representa a variante de cópia dentro de uma família de funções de atribuição. Enquanto a sobrecarga por movimentação [SWS_CORE_03085] está declarada como conditionally exception safe, as demais atribuições – por exemplo, via substrings [SWS_CORE_03086], views de cadeia de caracteres [SWS_CORE_03087] ou intervalos de iteradores [SWS_CORE_03091] – compartilham a propriedade not exception safe. Como não há segurança de thread especificada, uma chamada concorrente na mesma instância sem sincronização externa deverá ser não reentrante e insegura para dados. Pergunta Q-37d67c851a296f55 (aberta)

A sobrecarga de movimentação da função membro assign de acordo com [SWS_CORE_03085] atribui de forma síncrona a uma instância existente de ara::core::BasicString o conteúdo da referência rvalue str (declarada no arquivo de cabeçalho ara/core/string.h). A função retorna uma referência ao objeto chamador (*this). O comportamento funcional baseia-se na definição correspondente em [basic.string] do padrão C++.

Em relação ao tratamento de erros e exceções, o método é declarado como condicionalmente seguro contra exceções (conditionally exception safe) [SWS_CORE_03085]. O lançamento de exceções é excluído por meio de noexcept se, e somente se, o alocador propagar a atribuição por movimentação (propagate_on_container_move_assignment::value) ou as instâncias de alocador forem sempre consideradas iguais (is_always_equal::value). Diferentemente de outras funções de atribuição como [SWS_CORE_03086] ou [SWS_CORE_03088], que disparam violações específicas como IsoStdOutOfRangeViolation ou IsoStdLengthErrorViolation em caso de violação de intervalo ou comprimento e são consideradas não seguras contra exceções, esta operação não define AUTOSAR violations adicionais.

Na interação com sobrecargas alternativas de BasicString::assign – por exemplo, para referências lvalue constantes segundo [SWS_CORE_03084], visualizações via [SWS_CORE_03087] ou buffers de cadeia de caracteres de acordo com [SWS_CORE_03089] – a variante rvalue permite uma atribuição eficiente em termos de recursos sem nova alocação de memória. Interpretação: Após a transferência, o objeto de origem str provavelmente permanece em um estado válido, porém não especificado, como é habitual para operações de movimentação de acordo com [basic.string]. Pergunta Q-88c8157963cdd7e0 (aberta)

A função de membro assign da classe ara::core::BasicString ([SWS_CORE_03086]), disponibilizada através do cabeçalho ara/core/string.h, atribui sincronamente à instância atual um intervalo de uma cadeia de caracteres de origem transmitida str. A chamada aceita, além da referência de origem str, o índice inicial pos e, opcionalmente, a quantidade de caracteres n, para a qual npos está definido por padrão. Após a atribuição, é retornada uma referência ao objeto modificado (*this). A semântica funcional corresponde, neste contexto, fundamentalmente aos requisitos de [basic.string] ([SWS_CORE_03086]).

No tratamento de erros, existe uma divergência explícita em relação ao padrão ISO C++: caso a condição pos > str.size() se aplique, não é lançada uma std::out_of_range, mas sim provocada uma IsoStdOutOfRangeViolation ([SWS_CORE_03086]). Além disso, a função está expressamente classificada na especificação como não segura contra exceções (not exception safe) ([SWS_CORE_03086]).

No conjunto de métodos de atribuição de ara::core::BasicString, esta sobrecarga de substring complementa a atribuição de cadeias de caracteres completas ([SWS_CORE_03084]), a atribuição por movimentação (move) condicionalmente segura contra exceções ([SWS_CORE_03085]), a atribuição a partir de uma StringView ([SWS_CORE_03087]), bem como operações com buffers de caracteres ([SWS_CORE_03088]) ou intervalos de iteradores ([SWS_CORE_03091]).

usar

A função de membro assign para StringView ([SWS_CORE_03087]) substitui o conteúdo de uma instância de ara::core::BasicString sincronamente pelos caracteres da visualização de cadeia de caracteres transmitida. A semântica segue a definição correspondente em [basic.string] da biblioteca padrão C++. Como valor de retorno, a função fornece uma referência ao objeto de destino modificado (BasicString &), o que permite o encadeamento de chamadas sucessivas de métodos. A declaração é disponibilizada através do arquivo de cabeçalho #include "ara/core/string.h".

Tratamento de erros e segurança de exceções

A função está identificada na especificação como not exception safe ([SWS_CORE_03087]). Interpretação: Caso a atribuição exija um aumento da capacidade do buffer interno e essa alocação de memória falhe, uma exceção deverá ser lançada sem que haja garantia para o estado inalterado da instância. Pergunta (aberta)

Simultaneidade e restrições

Interpretação: Chamadas de assign na mesma instância de ara::core::BasicString não são thread-safe e requerem sincronização externa no caso de acesso simultâneo de leitura ou escrita por múltiplas threads. Pergunta Q-12774d6cd363b032 (aberta)

Interação

A função complementa o espectro de atribuições de ara::core::BasicString com visualizações com segurança de tipos. Ela existe ao lado das sobrecargas para atribuições por cópia e movimentação ([SWS_CORE_03084], [SWS_CORE_03085]), substrings ([SWS_CORE_03086]), ponteiros para dados de caracteres ([SWS_CORE_03088], [SWS_CORE_03089]), repetições de caracteres ([SWS_CORE_03090]), intervalos de iteradores ([SWS_CORE_03091]) e listas de inicializadores ([SWS_CORE_03092]).

usar

A função de membro assign da classe ara::core::BasicString atribui à instância de cadeia de caracteres atual sincronamente os primeiros n caracteres do array de caracteres transmitido s do tipo const value_type* e retorna uma referência ao objeto modificado (*this) [SWS_CORE_03088]. O comportamento funcional corresponde fundamentalmente à definição conforme [basic.string], em que o AUTOSAR substitui o tipo de parâmetro genérico charT por value_type [SWS_CORE_03088].

Tratamento de erros e condições de contorno

A atribuição está especificada como não segura contra exceções (not exception safe) [SWS_CORE_03088]. Se o comprimento especificado n exceder o tamanho máximo representável max_size() (n > max_size()), a função desencadeia a violação AUTOSAR IsoStdLengthErrorViolation em vez de std::length_error [SWS_CORE_03088]. Interpretação: O chamador provavelmente terá de assegurar que s aponte para pelo menos n caracteres válidos, uma vez que a especificação não define uma verificação de buffer à parte. Pergunta Q-290c36db79f27a0a (aberta)

Interação

A função é adequada primariamente para buffers não terminados em nulo ou partes de arrays. Ela complementa a sobrecarga assign(const value_type* s) [SWS_CORE_03089], na qual o comprimento é determinado implicitamente. No conjunto de classes de ara::core::BasicString existem outras sobrecargas de atribuição para aceitação de cadeias de caracteres existentes por cópia [SWS_CORE_03084] ou movimentação [SWS_CORE_03085], para a atribuição de substrings com verificação de índice [SWS_CORE_03086], para aceitação a partir de StringView [SWS_CORE_03087], bem como para repetições de caracteres [SWS_CORE_03090], intervalos de iteradores [SWS_CORE_03091] e listas de inicialização [SWS_CORE_03092].

A função-membro síncrona assign da classe ara::core::BasicString ([SWS_CORE_03089]) do cabeçalho ara/core/string.h substitui o conteúdo atual de um objeto de cadeia de caracteres pela sequência de caracteres fornecida s do tipo const value_type*. A chamada retorna uma referência para o objeto modificado (*this). O comportamento funcional segue as diretrizes do padrão ISO C++ para [basic.string] com a divergência documentada de que o tipo de caractere charT é substituído por value_type ([SWS_CORE_03089]). Interpretação: Na falta de um parâmetro de comprimento separado, o ponteiro s provavelmente deve apontar para um array de caracteres terminado em nulo. Pergunta Q-eea79e929750c27f (aberta)

Em relação ao tratamento de erros e à robustez, a função de atribuição é classificada como não segura contra exceções (not exception safe) ([SWS_CORE_03089]). Ao contrário de sobrecargas relacionadas como assign(const BasicString&, size_type, size_type) ([SWS_CORE_03086]) ou assign(const value_type*, size_type) ([SWS_CORE_03088]), não há violações de tempo de execução específicas como IsoStdOutOfRangeViolation ou IsoStdLengthErrorViolation definidas para esta variante.

No módulo core, a função faz parte de uma abrangente família de sobrecargas para atribuição de conteúdo. Esta abrange, além de ponteiros brutos, também strings completas ([SWS_CORE_03084]), semântica de movimentação ([SWS_CORE_03085]), instâncias de StringView ([SWS_CORE_03087]), caracteres individuais repetidos ([SWS_CORE_03090]), intervalos de iteradores ([SWS_CORE_03091]) e listas de inicialização ([SWS_CORE_03092]). A AUTOSAR também disponibiliza padrões de atribuição semelhantes em tipos de contêiner como ara::core::Vector ([SWS_CORE_01328]).

usar

A função-membro assign da classe ara::core::BasicString (definida em #include "ara/core/string.h") substitui o conteúdo atual da cadeia de caracteres de forma síncrona por n cópias consecutivas do caractere c do tipo value_type [SWS_CORE_03090]. A semântica corresponde à definição para [basic.string] com a divergência de que o parâmetro de tipo charT é substituído por value_type [SWS_CORE_03090]. Como valor de retorno, a função fornece uma referência lvalue para a instância modificada (*this), o que possibilita o encadeamento de outras operações.

Tratamento de erros e segurança contra exceções

De acordo com a especificação, a operação é explicitamente classificada como not exception safe [SWS_CORE_03090]. Ao contrário de outras sobrecargas que disparam violações definidas como IsoStdOutOfRangeViolation [SWS_CORE_03086] ou IsoStdLengthErrorViolation [SWS_CORE_03088] em caso de extrapolação de limites, esta função não nomeia violações específicas. Se uma alocação de memória necessária falhar, não existem garantias sobre a manutenção do estado anterior do objeto.

Simultaneidade e restrições

Como a atribuição modifica o buffer interno diretamente e nenhuma sincronização interna é especificada, o acesso simultâneo de múltiplas threads à mesma instância provavelmente não é thread-safe (interpretação). Pergunta Q-50f419c4bca5c151 (aberta) Chamadas paralelas devem ser coordenadas externamente pelo chamador.

Interação

A função complementa o portfólio de atribuições de ara::core::BasicString, que, além de atribuições de cópia e movimentação [SWS_CORE_03084], [SWS_CORE_03085], bem como iteradores e listas de inicializadores [SWS_CORE_03091], [SWS_CORE_03092], também disponibiliza interfaces para string views [SWS_CORE_03087]. Um padrão de atribuição comparável com quantidade de repetições existe de forma análoga para ara::core::Vector::assign [SWS_CORE_01329].