blob: 977b3f921d3bae488ac99c033b4090d7f3e254f9 [file] [log] [blame]
"use strict";(self.webpackChunkdoris_website=self.webpackChunkdoris_website||[]).push([[21159],{15680:(e,n,r)=>{r.d(n,{xA:()=>y,yg:()=>f});var t=r(296540);function a(e,n,r){return n in e?Object.defineProperty(e,n,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[n]=r,e}function o(e,n){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var t=Object.getOwnPropertySymbols(e);n&&(t=t.filter((function(n){return Object.getOwnPropertyDescriptor(e,n).enumerable}))),r.push.apply(r,t)}return r}function i(e){for(var n=1;n<arguments.length;n++){var r=null!=arguments[n]?arguments[n]:{};n%2?o(Object(r),!0).forEach((function(n){a(e,n,r[n])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):o(Object(r)).forEach((function(n){Object.defineProperty(e,n,Object.getOwnPropertyDescriptor(r,n))}))}return e}function s(e,n){if(null==e)return{};var r,t,a=function(e,n){if(null==e)return{};var r,t,a={},o=Object.keys(e);for(t=0;t<o.length;t++)r=o[t],n.indexOf(r)>=0||(a[r]=e[r]);return a}(e,n);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(t=0;t<o.length;t++)r=o[t],n.indexOf(r)>=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(a[r]=e[r])}return a}var l=t.createContext({}),c=function(e){var n=t.useContext(l),r=n;return e&&(r="function"==typeof e?e(n):i(i({},n),e)),r},y=function(e){var n=c(e.components);return t.createElement(l.Provider,{value:n},e.children)},p="mdxType",u={inlineCode:"code",wrapper:function(e){var n=e.children;return t.createElement(t.Fragment,{},n)}},d=t.forwardRef((function(e,n){var r=e.components,a=e.mdxType,o=e.originalType,l=e.parentName,y=s(e,["components","mdxType","originalType","parentName"]),p=c(r),d=a,f=p["".concat(l,".").concat(d)]||p[d]||u[d]||o;return r?t.createElement(f,i(i({ref:n},y),{},{components:r})):t.createElement(f,i({ref:n},y))}));function f(e,n){var r=arguments,a=n&&n.mdxType;if("string"==typeof e||a){var o=r.length,i=new Array(o);i[0]=d;var s={};for(var l in n)hasOwnProperty.call(n,l)&&(s[l]=n[l]);s.originalType=e,s[p]="string"==typeof e?e:a,i[1]=s;for(var c=2;c<o;c++)i[c]=r[c];return t.createElement.apply(null,i)}return t.createElement.apply(null,r)}d.displayName="MDXCreateElement"},845625:(e,n,r)=>{r.r(n),r.d(n,{assets:()=>l,contentTitle:()=>i,default:()=>u,frontMatter:()=>o,metadata:()=>s,toc:()=>c});var t=r(58168),a=(r(296540),r(15680));const o={title:"array_position",language:"en"},i=void 0,s={unversionedId:"sql-manual/sql-functions/array-functions/array_position",id:"version-1.2/sql-manual/sql-functions/array-functions/array_position",title:"array_position",description:"\x3c!--",source:"@site/versioned_docs/version-1.2/sql-manual/sql-functions/array-functions/array_position.md",sourceDirName:"sql-manual/sql-functions/array-functions",slug:"/sql-manual/sql-functions/array-functions/array_position",permalink:"/docs/1.2/sql-manual/sql-functions/array-functions/array_position",draft:!1,tags:[],version:"1.2",frontMatter:{title:"array_position",language:"en"},sidebar:"docs",previous:{title:"array_sortby",permalink:"/docs/1.2/sql-manual/sql-functions/array-functions/array_sortby"},next:{title:"array_contains",permalink:"/docs/1.2/sql-manual/sql-functions/array-functions/array_contains"}},l={},c=[{value:"array_position",id:"array_position",level:2},{value:"description",id:"description",level:3},{value:"Syntax",id:"syntax",level:4},{value:"notice",id:"notice",level:3},{value:"example",id:"example",level:3},{value:"keywords",id:"keywords",level:3}],y={toc:c},p="wrapper";function u(e){let{components:n,...r}=e;return(0,a.yg)(p,(0,t.A)({},y,r,{components:n,mdxType:"MDXLayout"}),(0,a.yg)("h2",{id:"array_position"},"array_position"),(0,a.yg)("version",{since:"1.2.0"},(0,a.yg)("p",null,"array_position")),(0,a.yg)("h3",{id:"description"},"description"),(0,a.yg)("h4",{id:"syntax"},"Syntax"),(0,a.yg)("p",null,(0,a.yg)("inlineCode",{parentName:"p"},"BIGINT array_position(ARRAY<T> arr, T value)")),(0,a.yg)("p",null,"Returns a position/index of first occurrence of the ",(0,a.yg)("inlineCode",{parentName:"p"},"value")," in the given array."),(0,a.yg)("pre",null,(0,a.yg)("code",{parentName:"pre"},"position - value position in array (starts with 1);\n0 - if value does not present in the array;\nNULL - when array is NULL.\n")),(0,a.yg)("h3",{id:"notice"},"notice"),(0,a.yg)("p",null,(0,a.yg)("inlineCode",{parentName:"p"},"Only supported in vectorized engine")),(0,a.yg)("h3",{id:"example"},"example"),(0,a.yg)("pre",null,(0,a.yg)("code",{parentName:"pre"},"mysql> set enable_vectorized_engine=true;\n\nmysql> SELECT id,c_array,array_position(c_array, 5) FROM `array_test`;\n+------+-----------------+------------------------------+\n| id | c_array | array_position(`c_array`, 5) |\n+------+-----------------+------------------------------+\n| 1 | [1, 2, 3, 4, 5] | 5 |\n| 2 | [6, 7, 8] | 0 |\n| 3 | [] | 0 |\n| 4 | NULL | NULL |\n+------+-----------------+------------------------------+\n\nmysql> select array_position([1, null], null);\n+--------------------------------------+\n| array_position(ARRAY(1, NULL), NULL) |\n+--------------------------------------+\n| 2 |\n+--------------------------------------+\n1 row in set (0.01 sec)\n")),(0,a.yg)("h3",{id:"keywords"},"keywords"),(0,a.yg)("p",null,"ARRAY,POSITION,ARRAY_POSITION"))}u.isMDXComponent=!0}}]);