고전적 표현들

QkDurationType_Dt시스템 시간 단위 (이 QkDurationInfo 일 때 ty 활성화됨)

실시간 값 (다른 모든 기간 유형에 적용됨)

QkExprNodeKind qk_expr_kind(const QkExprNode *expr)

고전식 표현식 노드의 유형을 반환합니다.

예

QKExprNodeKind kind = qk_expr_kind(expr);

안전

QkExprNode가 에 대한 유효하고 null이 아닌 포인터가 아닌 경우 expr , 동작은 정의되지 않습니다.

매개변수

• expr – 검사할 표현식 노드에 대한 포인터.

리턴

어떤 구체적인 표현 변형이 expr 포함되어 있는지를 설명하는 kind 열거형입니다.

QkBinaryExprInfo qk_expr_binary_info(const QkExprNode *expr)

이진 표현식 노드에서 정보를 추출합니다.

가 이진 표현식 노드를 가리키지 않으면 expr 오류가 발생합니다.

예

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

안전

QkExprNode가 에 대한 유효하고 null이 아닌 포인터가 아닌 경우 expr , 동작은 정의되지 않습니다.

매개변수

• expr – 이항 표현식 노드를 가리키는 포인터.

리턴

연산자, 피연산자, 결과 유형 및 해당 식이 상수인지 여부를 설명하는 구조체 QkBinaryExprInfo .

QkUnaryExprInfo qk_expr_unary_info(const QkExprNode *expr)

단항 식 노드에서 정보를 추출합니다.

가 단항 표현식 노드를 가리키지 않으면 expr 오류가 발생합니다.

예

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

안전

QkExprNode가 에 대한 유효하고 null이 아닌 포인터가 아닌 경우 expr , 동작은 정의되지 않습니다.

매개변수

• expr – 단항 식 노드를 가리키는 포인터.

리턴

연산자, 피연산자, 결과 유형 및 해당 식이 상수인지 여부를 설명하는 구조체 QkUnaryExprInfo .

QkCastExprInfo qk_expr_cast_info(const QkExprNode *expr)

캐스트 표현식 노드에서 정보를 추출합니다.

이 노드가 캐스트 표현식 노드를 가리키지 않으면 expr 오류가 발생합니다.

예

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

안전

QkExprNode가 에 대한 유효하고 null이 아닌 포인터가 아닌 경우 expr , 동작은 정의되지 않습니다.

매개변수

• expr – 형변환 표현식 노드를 가리키는 포인터.

리턴

피연산자, 할당 대상 유형, 형 변환이 암시적인지 여부, 그리고 식이 상수인지 여부를 설명하는 구조체 QkCastExprInfo .

QkIndexExprInfo qk_expr_index_info(const QkExprNode *expr)

인덱스 표현식 노드에서 정보를 추출합니다.

가 인덱스 표현식 노드를 가리키지 않으면 expr 오류가 발생합니다.

예

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

안전

QkExprNode가 에 대한 유효하고 null이 아닌 포인터가 아닌 경우 expr , 동작은 정의되지 않습니다.

매개변수

• expr – 인덱스 표현식 노드를 가리키는 포인터.

리턴

인덱스 대상, 인덱스 표현식, 결과 유형 및 해당 표현식이 상수인지 여부를 설명하는 구조체입니다 QkIndexExprInfo .

const QkValue *qk_expr_as_value(const QkExprNode *expr)

표현식 노드의 기본 값을 보여주는 뷰를 반환합니다.

가 값 표현식 노드를 가리키지 않으면 expr 오류가 발생합니다.

예

const QkValue *value = qk_expr_as_value(expr);

안전

QkExprNode가 에 대한 유효하고 null이 아닌 포인터가 아닌 경우 expr , 동작은 정의되지 않습니다.

매개변수

• expr – 값 표현식 노드를 가리키는 포인터.

리턴

expr안에 저장된 에 QkValue 대한 포인터.

const QkVar *qk_expr_as_var(const QkExprNode *expr)

식 노드의 기본 변수에 대한 뷰를 반환합니다.

가 변수 표현식 노드를 가리키지 않으면 expr 오류가 발생합니다.

예

const QkVar *var = qk_expr_as_var(expr);

안전

QkExprNode가 에 대한 유효하고 null이 아닌 포인터가 아닌 경우 expr , 동작은 정의되지 않습니다.

매개변수

• expr – 변수 표현식 노드를 가리키는 포인터.

리턴

expr안에 저장된 에 QkVar 대한 포인터.

const QkStretch *qk_expr_as_stretch(const QkExprNode *expr)

표현식 노드의 기본 구간을 보여주는 뷰를 반환합니다.

가 스트레치 표현식 노드를 가리키지 않으면 expr 오류가 발생합니다.

예

const QkStretch *stretch = qk_expr_as_stretch(expr);

안전

QkExprNode가 에 대한 유효하고 null이 아닌 포인터가 아닌 경우 expr , 동작은 정의되지 않습니다.

매개변수

• expr – 스트레치 표현식 노드를 가리키는 포인터.

리턴

expr안에 저장된 에 QkStretch 대한 포인터.

QkExprTypeInfo qk_value_type_info(const QkValue *value)

값의 유형 정보를 반환합니다.

예

QkExprTypeInfo type_info = qk_value_type_info(value);

안전

Value가 에 대한 유효하고 null이 아닌 포인터가 아닌 경우 value , 동작은 정의되지 않습니다.

매개변수

• value – 검사할 대상에 QkValue 대한 포인터.

리턴

값 유형 정보를 포함하는 구조체 QkExprTypeInfo .

QkDurationInfo qk_value_duration_info(const QkValue *value)

기간 값에서 구조화된 정보를 추출합니다.

가 지속 시간 값을 가리키지 않으면 value 오류가 발생합니다.

예

QkDurationInfo info = qk_value_duration_info(value);

안전

QkValue가 에 대한 유효하고 null이 아닌 포인터가 아닌 경우 value , 동작은 정의되지 않습니다.

매개변수

• 값 – 지속 시간 값을 가리키는 포인터.

리턴

기간 단위와 원시 값을 포함하는 구조체 QkDurationInfo .

double qk_value_float(const QkValue *value)

QkValue.에서 부동소수점 값을 추출합니다.

가 부동소수점 값을 가리키지 않으면 value 오류가 발생합니다.

예

double raw = qk_value_float(value);

안전

QkValue가 에 대한 유효하고 null이 아닌 포인터가 아닌 경우 value , 동작은 정의되지 않습니다.

매개변수

• 값 – float 형 값을 가리키는 포인터.

리턴

value.에 저장된 값은 double

uint64_t qk_value_uint(const QkValue *value)

QkExprType_Uint형 QkValue 인 에서 부호 없는 정수 값을 추출합니다.

이 함수를 호출하기 전에 값이 에 uint64_t 들어갈 수 있는지 확인하려면 를 사용해야 qk_value_type_info 합니다.

uint64_t가 QkExprType_Uint 어떤 값도 가리키지 않거나, 저장된 정수 값이 에 들어가지 않을 경우 value 예외가 발생합니다.

예

uint64_t raw = qk_value_uint(value);

안전

QkValue가 에 대한 유효하고 null이 아닌 포인터가 아닌 경우 value , 동작은 정의되지 않습니다.

매개변수

• 값 – uint 값을 가리키는 포인터.

리턴

정수 값을 변환한 결과 uint64_t.

bool qk_value_bool(const QkValue *value)

QkExprType_Bool유형 인 QkValue 에서 값을 추출합니다.

가 bool 값을 가리키지 않으면 value 오류가 발생합니다.

예

bool raw = qk_value_bool(value);

안전

QkValue가 에 대한 유효하고 null이 아닌 포인터가 아닌 경우 value , 동작은 정의되지 않습니다.

매개변수

• 값 – bool 값을 가리키는 포인터.

리턴

true 저장된 정수 표현이 0이 아닌 경우, 그렇지 않으면 false.

char *qk_var_name(const QkVar *var)

변수의 이름을 새로 할당된 C 문자열로 반환합니다.

예

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

안전

QkVar가 에 대한 유효하고 null이 아닌 포인터가 아닌 경우 var , 동작은 정의되지 않습니다.

매개변수

• var – 검사할 변수를 가리키는 포인터.

리턴

변수 이름을 포함하는 널 종결 문자열, 또는 NULL if var 가 독립형이 아닌 변수(즉, 고전 비트나 고전 레지스터에 기반한 변수)를 가리키는 경우. qk_str_free호출자는 반환된 문자열을 소유하고 있으므로, 이를.을 사용하여 해제해야 합니다.

QkExprTypeInfo qk_var_type_info(const QkVar *var)

변수에 대한 전체 유형 정보를 반환합니다.

값이 다소 변동성이 있을 경우 var 오류가 발생하는데, 이는 현재 이 API에서 아직 지원되지 않습니다.

예

QkExprTypeInfo type_info = qk_var_type_info(var);

안전

QkVar가 에 대한 유효하고 null이 아닌 포인터가 아닌 경우 var , 동작은 정의되지 않습니다.

매개변수

• var – 검사할 변수를 가리키는 포인터.

리턴

변수 유형 정보를 포함하는 구조체 QkExprTypeInfo .

char *qk_stretch_name(const QkStretch *stretch)

스트레치의 이름을 반환합니다.

예

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

안전

QkStretch가 에 대한 유효하고 null이 아닌 포인터가 아닌 경우 stretch , 동작은 정의되지 않습니다.

매개변수

• stretch – 검사할 stretch에 대한 포인터.

리턴

스트레치 이름이 포함된 널 종결 문자열. qk_str_free호출자는 반환된 문자열의 소유자이므로, 이를.을 사용하여 해제해야 합니다.