[jOOQ/jOOQ#12492] Clarify whether .offset(..) starts from 0 or 1

This commit is contained in:
Lukas Eder 2021-10-14 14:05:55 +02:00
parent 53db69b8f9
commit 11e59a8ed7
3 changed files with 30 additions and 9 deletions

View File

@ -290,7 +290,9 @@ public interface SelectLimitStep<R extends Record> extends SelectForUpdateStep<R
SelectLimitPercentAfterOffsetStep<R> limit(Param<? extends Number> offset, Param<? extends Number> numberOfRows);
/**
* Add an <code>OFFSET</code> clause to the query
* Add a 0-based <code>OFFSET</code> clause to the query.
* <p>
* Offsets are 0-based as they describe the number of rows to <em>skip</em>.
* <p>
* If there is no <code>LIMIT .. OFFSET</code> or <code>TOP</code> clause in
* your RDBMS, or if your RDBMS does not natively support offsets, this is
@ -302,7 +304,9 @@ public interface SelectLimitStep<R extends Record> extends SelectForUpdateStep<R
SelectLimitAfterOffsetStep<R> offset(int offset);
/**
* Add an <code>OFFSET</code> clause to the query
* Add a 0-based <code>OFFSET</code> clause to the query.
* <p>
* Offsets are 0-based as they describe the number of rows to <em>skip</em>.
* <p>
* If there is no <code>LIMIT .. OFFSET</code> or <code>TOP</code> clause in
* your RDBMS, or if your RDBMS does not natively support offsets, this is
@ -314,7 +318,10 @@ public interface SelectLimitStep<R extends Record> extends SelectForUpdateStep<R
SelectLimitAfterOffsetStep<R> offset(Number offset);
/**
* Add an <code>OFFSET</code> clause to the query using a named parameter
* Add a 0-based <code>OFFSET</code> clause to the query using a named
* parameter
* <p>
* Offsets are 0-based as they describe the number of rows to <em>skip</em>.
* <p>
* If there is no <code>LIMIT .. OFFSET</code> or <code>TOP</code> clause in
* your RDBMS, or if your RDBMS does not natively support offsets, this is

View File

@ -133,7 +133,9 @@ import static org.jooq.SQLDialect.YUGABYTE;
public interface SelectOffsetStep<R extends Record> extends SelectForUpdateStep<R> {
/**
* Add an <code>OFFSET</code> clause to the query.
* Add a 0-based <code>OFFSET</code> clause to the query.
* <p>
* Offsets are 0-based as they describe the number of rows to <em>skip</em>.
* <p>
* If there is no <code>LIMIT .. OFFSET</code> or <code>TOP</code> clause in
* your RDBMS, or if your RDBMS does not natively support offsets, this is
@ -145,7 +147,9 @@ public interface SelectOffsetStep<R extends Record> extends SelectForUpdateStep<
SelectForUpdateStep<R> offset(int offset);
/**
* Add an <code>OFFSET</code> clause to the query.
* Add a 0-based <code>OFFSET</code> clause to the query.
* <p>
* Offsets are 0-based as they describe the number of rows to <em>skip</em>.
* <p>
* If there is no <code>LIMIT .. OFFSET</code> or <code>TOP</code> clause in
* your RDBMS, or if your RDBMS does not natively support offsets, this is
@ -157,7 +161,10 @@ public interface SelectOffsetStep<R extends Record> extends SelectForUpdateStep<
SelectForUpdateStep<R> offset(Number offset);
/**
* Add an <code>OFFSET</code> clause to the query using a named parameter.
* Add a 0-based <code>OFFSET</code> clause to the query using a named
* parameter.
* <p>
* Offsets are 0-based as they describe the number of rows to <em>skip</em>.
* <p>
* If there is no <code>LIMIT .. OFFSET</code> or <code>TOP</code> clause in
* your RDBMS, or if your RDBMS does not natively support offsets, this is

View File

@ -684,7 +684,9 @@ public interface SelectQuery<R extends Record> extends Select<R>, ConditionProvi
void addSeekBefore(Collection<? extends Field<?>> fields);
/**
* Add an <code>OFFSET</code> clause to the query.
* Add a 0-based <code>OFFSET</code> clause to the query.
* <p>
* Offsets are 0-based as they describe the number of rows to <em>skip</em>.
* <p>
* If there is no <code>LIMIT .. OFFSET</code> or <code>TOP</code> clause in
* your RDBMS, or if your RDBMS does not natively support offsets, this is
@ -695,7 +697,9 @@ public interface SelectQuery<R extends Record> extends Select<R>, ConditionProvi
void addOffset(int offset);
/**
* Add an <code>OFFSET</code> clause to the query.
* Add a 0-based <code>OFFSET</code> clause to the query.
* <p>
* Offsets are 0-based as they describe the number of rows to <em>skip</em>.
* <p>
* If there is no <code>LIMIT .. OFFSET</code> or <code>TOP</code> clause in
* your RDBMS, or if your RDBMS does not natively support offsets, this is
@ -706,7 +710,10 @@ public interface SelectQuery<R extends Record> extends Select<R>, ConditionProvi
void addOffset(Number offset);
/**
* Add an <code>OFFSET</code> clause to the query using a named parameter.
* Add a 0-based <code>OFFSET</code> clause to the query using a named
* parameter.
* <p>
* Offsets are 0-based as they describe the number of rows to <em>skip</em>.
* <p>
* If there is no <code>LIMIT .. OFFSET</code> or <code>TOP</code> clause in
* your RDBMS, or if your RDBMS does not natively support offsets, this is