Expressões clássicas

QkDurationType_DtUnidades de tempo do sistema (ativas quando ty está em QkDurationInfo )

Valor em tempo real (ativo para todos os outros tipos de duração)

QkExprNodeKind qk_expr_kind(const QkExprNode *expr)

Retorna o tipo de um nó de expressão clássico.

Exemplo

QKExprNodeKind kind = qk_expr_kind(expr);

Segurança

O comportamento é indefinido se expr não for um ponteiro válido e não nulo para um QkExprNode.

Parâmetros

• expr – Um ponteiro para o nó de expressão a ser inspecionado.

Retorna

A enumeração do tipo que descreve qual variante expr de expressão concreta está contida.

QkBinaryExprInfo qk_expr_binary_info(const QkExprNode *expr)

Extrair informações de um nó de expressão binária.

Gera um erro de panico se expr não apontar para um nó de expressão binária.

Exemplo

QkBinaryExprInfo info = qk_expr_binary_info(expr);
const QkExprNode *lhs = info.left;
const QkExprNode *rhs = info.right;

Segurança

O comportamento é indefinido se expr não for um ponteiro válido e não nulo para um QkExprNode.

Parâmetros

• expr – Um ponteiro para um nó de expressão binária.

Retorna

Uma QkBinaryExprInfo estrutura que descreve o operador, os operandos, o tipo do resultado e se a expressão é constante.

QkUnaryExprInfo qk_expr_unary_info(const QkExprNode *expr)

Extrair informações de um nó de expressão unária.

Gera uma exceção se expr não apontar para um nó de expressão unária.

Exemplo

QkUnaryExprInfo info = qk_expr_unary_info(expr);
QkUnaryOpType op = info.op;

Segurança

O comportamento é indefinido se expr não for um ponteiro válido e não nulo para um QkExprNode.

Parâmetros

• expr – Um ponteiro para um nó de expressão unária.

Retorna

Uma QkUnaryExprInfo estrutura que descreve o operador, o operando, o tipo do resultado e se a expressão é uma constante.

QkCastExprInfo qk_expr_cast_info(const QkExprNode *expr)

Extrair informações de um nó de expressão de conversão.

Gera um erro se expr não apontar para um nó de expressão de conversão.

Exemplo

QkCastExprInfo info = qk_expr_cast_info(expr);
const QkExprNode *operand = info.operand;

Segurança

O comportamento é indefinido se expr não for um ponteiro válido e não nulo para um QkExprNode.

Parâmetros

• expr – Um ponteiro para um nó de expressão de conversão.

Retorna

Uma QkCastExprInfo estrutura que descreve o operando, o tipo de destino, se a conversão é implícita e se a expressão é constante.

QkIndexExprInfo qk_expr_index_info(const QkExprNode *expr)

Extrair informações de um nó de expressão de índice.

Gera um erro de panico se expr não apontar para um nó de expressão de índice.

Exemplo

QkIndexExprInfo info = qk_expr_index_info(expr);
const QkExprNode *target = info.target;
const QkExprNode *index = info.index;

Segurança

O comportamento é indefinido se expr não for um ponteiro válido e não nulo para um QkExprNode.

Parâmetros

• expr – Um ponteiro para um nó de expressão de índice.

Retorna

Uma QkIndexExprInfo estrutura que descreve o alvo indexado, a expressão de índice, o tipo do resultado e se a expressão é constante.

const QkValue *qk_expr_as_value(const QkExprNode *expr)

Retorna uma visualização do valor subjacente do nó de expressão.

Gera um erro de panico se expr não apontar para um nó de expressão de valor.

Exemplo

const QkValue *value = qk_expr_as_value(expr);

Segurança

O comportamento é indefinido se expr não for um ponteiro válido e não nulo para um QkExprNode.

Parâmetros

• expr – Um ponteiro para um nó de expressão de valor.

Retorna

Um ponteiro para o valor QkValue armazenado dentro de expr.

const QkVar *qk_expr_as_var(const QkExprNode *expr)

Retorna uma visualização da variável subjacente do nó de expressão.

Gera um erro de panico se expr não apontar para um nó de expressão variável.

Exemplo

const QkVar *var = qk_expr_as_var(expr);

Segurança

O comportamento é indefinido se expr não for um ponteiro válido e não nulo para um QkExprNode.

Parâmetros

• expr – Um ponteiro para um nó de expressão variável.

Retorna

Um ponteiro para o valor QkVar armazenado dentro de expr.

const QkStretch *qk_expr_as_stretch(const QkExprNode *expr)

Retorna uma visualização do trecho subjacente do nó de expressão.

Gera um erro se expr não apontar para um nó de expressão de extensão.

Exemplo

const QkStretch *stretch = qk_expr_as_stretch(expr);

Segurança

O comportamento é indefinido se expr não for um ponteiro válido e não nulo para um QkExprNode.

Parâmetros

• expr – Um ponteiro para um nó de expressão de extensão.

Retorna

Um ponteiro para o valor QkStretch armazenado dentro de expr.

QkExprTypeInfo qk_value_type_info(const QkValue *value)

Retorna as informações de tipo de um valor.

Exemplo

QkExprTypeInfo type_info = qk_value_type_info(value);

Segurança

O comportamento é indefinido se value não for um ponteiro válido e não nulo para um Value.

Parâmetros

• valor – Um ponteiro para o objeto QkValue a ser inspecionado.

Retorna

Uma QkExprTypeInfo estrutura que contém as informações sobre o tipo de valor.

QkDurationInfo qk_value_duration_info(const QkValue *value)

Extrair informações estruturadas a partir de um valor de duração.

Gera um erro se value não apontar para um valor de duração.

Exemplo

QkDurationInfo info = qk_value_duration_info(value);

Segurança

O comportamento é indefinido se value não for um ponteiro válido e não nulo para um QkValue.

Parâmetros

• valor – Um ponteiro para um valor de duração.

Retorna

Uma QkDurationInfo estrutura que contém a unidade de duração e o valor bruto.

double qk_value_float(const QkValue *value)

Extrair o valor de ponto flutuante de um QkValue.

Gera um erro se value não apontar para um valor do tipo float.

Exemplo

double raw = qk_value_float(value);

Segurança

O comportamento é indefinido se value não for um ponteiro válido e não nulo para um QkValue.

Parâmetros

• valor – Um ponteiro para um valor do tipo float.

Retorna

O double valor armazenado em value.

uint64_t qk_value_uint(const QkValue *value)

Extraia o valor inteiro sem sinal de um QkValue do tipo QkExprType_Uint.

Você deve usar qk_value_type_info para garantir que o valor caiba em uint64_t antes de chamar essa função.

Gera um erro de panico se value não apontar para um QkExprType_Uint valor ou se o inteiro armazenado não couber em uint64_t.

Exemplo

uint64_t raw = qk_value_uint(value);

Segurança

O comportamento é indefinido se value não for um ponteiro válido e não nulo para um QkValue.

Parâmetros

• value – Um ponteiro para um valor do tipo uint.

Retorna

O valor inteiro convertido para uint64_t.

bool qk_value_bool(const QkValue *value)

Extraia o valor de um QkValue do tipo QkExprType_Bool.

Gera um erro se value não apontar para um valor do tipo bool.

Exemplo

bool raw = qk_value_bool(value);

Segurança

O comportamento é indefinido se value não for um ponteiro válido e não nulo para um QkValue.

Parâmetros

• valor – Um ponteiro para um valor do tipo bool.

Retorna

false``true se a representação inteira armazenada for diferente de zero; caso contrário,.

char *qk_var_name(const QkVar *var)

Retorna o nome de uma variável como uma string C recém-alocada.

Exemplo

char *name = qk_var_name(var);
if (name != NULL) {
    // Use the name...
    qk_str_free(name);
}

Segurança

O comportamento é indefinido se var não for um ponteiro válido e não nulo para um QkVar.

Parâmetros

• var – Um ponteiro para a variável a ser inspecionada.

Retorna

Uma string terminada por caractere nulo contendo o nome da variável, ou NULL , caso var se trate de uma variável não autônoma (ou seja, baseada em um bit clássico ou em um registro clássico). A função de chamada é responsável pela string retornada e deve liberá-la com qk_str_free.

QkExprTypeInfo qk_var_type_info(const QkVar *var)

Retorna todas as informações de tipo de uma variável.

Gera um erro se var for um pouco variável, o que ainda não é suportado por esta API.

Exemplo

QkExprTypeInfo type_info = qk_var_type_info(var);

Segurança

O comportamento é indefinido se var não for um ponteiro válido e não nulo para um QkVar.

Parâmetros

• var – Um ponteiro para a variável a ser inspecionada.

Retorna

Uma QkExprTypeInfo estrutura que contém as informações sobre o tipo da variável.

char *qk_stretch_name(const QkStretch *stretch)

Retorna o nome de um trecho.

Exemplo

char *name = qk_stretch_name(stretch);
// Use the name...
qk_str_free(name);

Segurança

O comportamento é indefinido se stretch não for um ponteiro válido e não nulo para um QkStretch.

Parâmetros

• stretch – Um ponteiro para o trecho a ser inspecionado.

Retorna

Uma string terminada por caractere nulo contendo o nome do trecho. A função de chamada é responsável pela string retornada e deve liberá-la com qk_str_free.