ST_M

Définition

ST_M accepte un objet ST_Point comme paramètre en entrée et renvoie sa coordonnée de mesure (m).

Dans SQLite, la fonction ST_M permet également de mettre à jour une valeur de mesure.

Syntaxe

Oracle et PostgreSQL

sde.st_m (point1 sde.st_point)

SQLite

st_m (point1 geometryblob)
st_m (point1 geometryblob, new_Mvalue double)

Type de retour

Oracle et PostgreSQL

Nombre

SQLite

Double précision si la requête porte sur une valeur de mesure ; objet geometryblob pour la mise à jour d'une valeur de mesure

Exemples

Oracle

La table m_test est créée et trois points y sont insérés. Les trois contiennent des valeurs de mesure. Une instruction SELECT est exécutée avec la fonction ST_M pour renvoyer la valeur de mesure de chaque point.

CREATE TABLE m_test (
 id integer,
 geometry sde.st_point);

INSERT INTO M_TEST VALUES (
 1,
 sde.st_point (2, 3, 32, 5, 4322)
);

INSERT INTO M_TEST VALUES (
 2,
 sde.st_point (4, 5, 20, 4, 4326)
);

INSERT INTO M_TEST VALUES (
 3,
 sde.st_point (3, 8, 23, 7, 4326)
);

SELECT id, sde.st_m (geometry) M_COORD
 FROM M_TEST; 

        ID    M_COORD

         1          5
         2          4
         3          7

PostgreSQL

La table m_test est créée et trois points y sont insérés. Les trois contiennent des valeurs de mesure. Une instruction SELECT est exécutée avec la fonction ST_M pour renvoyer la valeur de mesure de chaque point.

CREATE TABLE m_test (
 id serial,
 geometry sde.st_point
);

INSERT INTO m_test (geometry) VALUES (
 sde.st_point (2, 3, 32, 5, 4326)
);

INSERT INTO m_test (geometry) VALUES (
 sde.st_point (4, 5, 20, 4, 4326)
);

INSERT INTO m_test (geometry) VALUES (
 sde.st_point (3, 8, 23, 7, 4326)
);

SELECT id, sde.st_m (geometry) 
 AS M_COORD
 FROM m_test; 

        id    m_coord

         1          5
         2          4
         3          7

SQLite

Dans le premier exemple, la table m_test est créée et trois points y sont insérés. Les trois contiennent des valeurs de mesure. Une instruction SELECT est exécutée avec la fonction ST_M pour renvoyer la valeur de mesure de chaque point.

CREATE TABLE m_test (
 id integer primary key autoincrement not null
);

SELECT AddGeometryColumn (
 NULL,
 'm_test',
 'geometry',
 4326,
 'pointzm',
 'xyzm',
 'null'
);

INSERT INTO m_test (geometry) VALUES (
 st_point (2, 3, 32, 5, 4326)
);

INSERT INTO m_test (geometry) VALUES (
 st_point (4, 5, 20, 4, 4326)
);

INSERT INTO m_test (geometry) VALUES (
 st_point (3, 8, 23, 7, 4326)
);

SELECT id, st_m (geometry) 
 AS M_COORD
 FROM m_test; 

id    m_coord

1     5.0
2     4.0
3     7.0

Dans ce deuxième exemple, la valeur de mesure est mise à jour pour l'enregistrement 3 dans la table m_test.

SELECT st_m (geometry, 7.5)
 FROM m_test
 WHERE id = 3;