Ignore:
File:
1 edited

Legend:

Unmodified
Added
Removed
  • uspace/lib/bithenge/src/expression.c

    r7c3fb9b r1433ecda  
    4747 * @param[out] self Expression to initialize.
    4848 * @param[in] ops Operations provided by the expression.
    49  * @return EOK or an error code from errno.h.
    50  */
     49 * @return EOK or an error code from errno.h. */
    5150errno_t bithenge_init_expression(bithenge_expression_t *self,
    5251    const bithenge_expression_ops_t *ops)
     
    157156                break;
    158157        case BITHENGE_EXPRESSION_INTEGER_DIVIDE:
    159                 /*
    160                  * Integer division can behave in three major ways when the
    161                  * operands are signed: truncated, floored, or Euclidean. When
     158                /* Integer division can behave in three major ways when the
     159                  operands are signed: truncated, floored, or Euclidean. When
    162160                 * b > 0, we give the same result as floored and Euclidean;
    163161                 * otherwise, we currently raise an error. See
    164162                 * https://en.wikipedia.org/wiki/Modulo_operation and its
    165                  * references.
    166                  */
     163                 * references. */
    167164                if (b_int <= 0) {
    168165                        rc = EINVAL;
     
    252249 * @param a The first operand.
    253250 * @param b The second operand.
    254  * @return EOK on success or an error code from errno.h.
    255  */
     251 * @return EOK on success or an error code from errno.h. */
    256252errno_t bithenge_binary_expression(bithenge_expression_t **out,
    257253    bithenge_binary_op_t op, bithenge_expression_t *a,
     
    309305/** Create an expression that gets the current input node.
    310306 * @param[out] out Holds the new expression.
    311  * @return EOK on success or an error code from errno.h.
    312  */
     307 * @return EOK on success or an error code from errno.h. */
    313308errno_t bithenge_in_node_expression(bithenge_expression_t **out)
    314309{
     
    344339/** Create an expression that gets the current node being created.
    345340 * @param[out] out Holds the new expression.
    346  * @return EOK on success or an error code from errno.h.
    347  */
     341 * @return EOK on success or an error code from errno.h. */
    348342errno_t bithenge_current_node_expression(bithenge_expression_t **out)
    349343{
     
    395389 * @param[out] out Holds the created expression.
    396390 * @param index The index of the parameter to get.
    397  * @return EOK on success or an error code from errno.h.
    398  */
     391 * @return EOK on success or an error code from errno.h. */
    399392errno_t bithenge_param_expression(bithenge_expression_t **out, int index)
    400393{
     
    461454 * @param[out] out Holds the created expression.
    462455 * @param node The constant.
    463  * @return EOK on success or an error code from errno.h.
    464  */
     456 * @return EOK on success or an error code from errno.h. */
    465457errno_t bithenge_const_expression(bithenge_expression_t **out,
    466458    bithenge_node_t *node)
     
    544536 * @param[out] out Holds the new expression.
    545537 * @param key The key to search for in nodes being created.
    546  * @return EOK on success or an error code from errno.h.
    547  */
     538 * @return EOK on success or an error code from errno.h. */
    548539errno_t bithenge_scope_member_expression(bithenge_expression_t **out,
    549540    bithenge_node_t *key)
     
    666657 * @param absolute_limit If true, the limit is an absolute offset; otherwise,
    667658 * it is relative to the start.
    668  * @return EOK on success or an error code from errno.h.
    669  */
     659 * @return EOK on success or an error code from errno.h. */
    670660errno_t bithenge_subblob_expression(bithenge_expression_t **out,
    671661    bithenge_expression_t *blob, bithenge_expression_t *start,
     
    825815 * @param transform The transform for which parameters are calculated.
    826816 * @param params The expressions used to calculate the parameters.
    827  * @return EOK on success or an error code from errno.h.
    828  */
     817 * @return EOK on success or an error code from errno.h. */
    829818errno_t bithenge_param_wrapper(bithenge_transform_t **out,
    830819    bithenge_transform_t *transform, bithenge_expression_t **params)
     
    910899 * @param[out] out Holds the new transform.
    911900 * @param expr The expression to evaluate.
    912  * @return EOK on success or an error code from errno.h.
    913  */
     901 * @return EOK on success or an error code from errno.h. */
    914902errno_t bithenge_expression_transform(bithenge_transform_t **out,
    915903    bithenge_expression_t *expr)
     
    968956 * @param[out] out Holds the new transform.
    969957 * @param expr The expression to evaluate.
    970  * @return EOK on success or an error code from errno.h.
    971  */
     958 * @return EOK on success or an error code from errno.h. */
    972959errno_t bithenge_inputless_transform(bithenge_transform_t **out,
    973960    bithenge_expression_t *expr)
     
    11301117 * @param a The first blob.
    11311118 * @param b The second blob.
    1132  * @return EOK on success or an error code from errno.h.
    1133  */
     1119 * @return EOK on success or an error code from errno.h. */
    11341120errno_t bithenge_concat_blob(bithenge_node_t **out, bithenge_blob_t *a,
    11351121    bithenge_blob_t *b)
     
    11731159 * @param b_expr An expression to calculate the second blob.
    11741160 * @param scope The scope in which @a b_expr should be evaluated.
    1175  * @return EOK on success or an error code from errno.h.
    1176  */
     1161 * @return EOK on success or an error code from errno.h. */
    11771162errno_t bithenge_concat_blob_lazy(bithenge_node_t **out, bithenge_blob_t *a,
    11781163    bithenge_expression_t *b_expr, bithenge_scope_t *scope)
Note: See TracChangeset for help on using the changeset viewer.