Функции

Функции

Используйте функции для:

• построения выражений.

Список функций доступен когда:

• открыт диалог “Выражение” или диалог “SQLdзапрос”.

Использование функций

В выражение могут входить один или несколько вызовов функций. В следующей ниже таблице num обозначает любое численное выражение (например, 5), str – любое строковое выражение (например, “км"), и obj – любое выражение типа "объект" (например, States. obj обозначает колонку, в которой регистрируется наличие графического объекта, в таблице States).

Математические функции

Abs( num )

Cos( num )

Int( num )

Maximum( num , num ) Minimum( num , num ) Round( num1, num2 )

Sin( num )

Tan( num )

Возвращает абсолютное значение (модуль) числа. Возвращает косинус числа, num задается в радианах. Возвращает целую часть числа.

Возвращает большее из двух чисел. Возвращает меньшее из двух чисел.

Возвращает число (num1), округленное до ближайшего значения num2 (например, если num2 равно десяти, то num1 округляется до ближайшего десятка).

Возвращает синус числа, num задается в радианах. Возвращает тангенс числа, num задается в радианах.

Функции для работы с датами

CurDate( )	Возвращает текущую дату.
Day( date )	Возвращает для date номер дня в месяце (от 1 до 31).
Month( date )	Возвращает для date номер месяца (от 1 до 12).
Weekday( date )	Возвращает для date номер дня в неделе (от 1 до 7); 1
	означает Воскресение.
Year( date )	Возвращает для date год (например, 1995).

Справочник MapBasic

535

Функции

Строчные функции

Chr$( num )

DeformatNumber$( str )

Format$( num , str )

FormatNumber$( num )

InStr( num , str1 , str2 )

LCase$( str )

Left$( str , num )

Len( str )

LTrim$( str )

Mid$( str, num1, num2 )

Proper$( str )

Right$( str , num )

RTrim$( str )

Str$( expr )

UCase$( str )

Возвращает символ, соответствующий его коду (например, Chr$(68) возвращает строку “D”).

Убирает из строки str все форматирование, выполненное функцией FormatNumber$ function, возвращая строку не содержащую разделители тысяч.

Возвращает строку, представляющую собой отформатированное по маске str число num. Например: Format$( 12345. 678, "$,#. ##") возвращает строку “$12,345. 68".

Возвращает строку, представляющую собой отформатированное значение числа num. Эту функцию легче использовать, чем Format$, но она предоставляет значительно меньшие возможности (например, получаемая строка всегда содержит разделители тысяч).

Ищет вхождение строки str2 в строке str1 начиная с позиции num. Чтобы начать поиск с начала строки, используйте для num значение 1.

Возвращает строку str, все буквы которой преобразованы к нижнему регистру.

Возвращает первые num символов строки.

Возвращает число символов в строке (длину строки).

Эта функция удаляет все начальные пробелы строки str и возвращает результат.

Возвращает часть строки str, начинающуюся с позиции num1 и имеющую длину в num2 символов.

Возвращает строку, в которой первая буква каждого слова преобразована к верхнему регистру.

Возвращает последние num символов строки str.

Эта функция удаляет все конечные пробелы строки str и возвращает результат.

Возвращает выражение expr в виде строки.

Возвращает строку str, все буквы которой преобразованы к верхнему регистру.

536	Справочник MapInfo

			Функции
Val( str )			Возвращает численное значение строки; например,
			Val("18") возвращает число 18. Передаваемая в качестве
			параметра строка, должна не иметь форматирующих
			символов (типа разделителя тысяч); чтобы получить
			неформатированную строку, вызовите DeformatNumd
			ber$.
Функции, возвращающие географические величины
Area( obj , str )			Возвращает площадь объекта obj. Параметр str задает
			единицы измерения пощади, например “sq mi" или “sq
			km".
CentroidX( obj )			Возвращает координату X центроида объекта.
CentroidY( obj )			Возвращает координату Y центроида объекта.
Distance( num_x , num_y ,			Возвращает расстояние между двумя точками. Первые
num_x2 , num_y2 , str )			два параметра задают координаты X и Y начальной
			точки, а следующие два – конечной точки; параметр str
			задает название единицы измерения, например “mi" или
			“km".
Perimeter( obj , str )			Возвращает периметр объекта. Параметр str задает
			единицу измерения расстояния, например “mi" или
			“km". Отличный от нуля периметр имеют только
			объекты типа область, эллипс и прямоугольник.
Функции, возвращающие объекты
Buffer( obj , num_res ,			Возвращает объект типа "область", представляющий
num_width , str )			буферную область. Параметр num_res определяет, из
			скольких узлов будут состоять окружности, входящие в
			состав буферной зоны; параметр num_width задает
			радиусы таких окружностей; параметр str задает имя
			единицы измерения (например, "mi" или "km"), в
			которых измеряется num_width.
Centroid( obj )			Возвращает объект типа "точка", расположенный в
			месте центроида объекта obj.
CreateCircle( num_x, num_y,			Возвращает объект типа "окружность"; параметр
num_radius )			num_radius задает радиус в милях.
CreateLine( num_x , num_y ,			Возвращает объект типа "линия".
num_x2 , num_y2 )
CreatePoint( num_x , num_y )			Возвращает объект типа "точка".
Справочник MapBasic	537

Функции

Каждая из этих функций возвращает графический объект. Вместе с командой Update в окне MapBasic, Вы можете использовать эти функции для создания объектов для каждой строчки Вашей таблицы. Например, если Ваша таблица содержит координаты двух точек в колонках x1, y1, x2, и y2, то следующая команда создает Линию для каждой строки Вашей таблицы:

Update tablename Set Obj = CreateLine(x1, y1, x2, y2)

Внимание: Команда Update переопределяет все графические объекты в Вашей таблице. Лучше сначала сделать копию таблицы и потренироваться на ней.

Смотри:

Руководство пользователя: Глава 8

538	Справочник MapInfo