IBM FileNet P8, Version 5.2.1            

Жол функциялары

Бұл бөлімде, жол мәндеріне қолданылатын функциялардың қысқаша сипаттамасы бар.

Кесте 1. Функциялар және оның мақсаттарының үстелі
Функция Ол не істейді
түрлендіру Жолды басқа дерек түріне түрлендіреді немесе басқа дерек түрін жолға түрлендіреді.
кодсыздандыру Кодсыздандырылған жол өрнегін, қайтара бастапқы жолға түрлендіреді.
кодтау Жол өрнегін, мағынасы жоқ мәтін жолына түрлендіреді.
алтылық Құрамында оналтылық таңбалы коды бар жол литералын, ASCII жолына аударады.
in_set Егер бір жол, басқа жолдан түгел таңбалардан құралған болса, дұрыс логикалық мәнді қайтарады.
is_number Егер жол өрнегі, қалқыма немесе бүтін сан мәніне есептелсе, дұрыс логикалық мән қайтарылады.
is_time Егер жол өрнегі, жарамды уақыт мәніне есептелсе, дұрыс логикалық мән қайтарылады.
ұзындық Жолдың ұзындығын қайтарады.

төмен

жоғары

Жол таңбаларын, кіші әріптерге немесе бас әріптерге өзгертеді.

ltrim

rtrim

жиектеу

Аралықты немесе көрсетілген таңбаларды, жолдың басынан (ltrim),соңынан (rtrim), немесе екі соңынан (trim) жояды.
ең көп Әрбір қолданған деректер түрі өрнектерінің тізімінен, ең үлкен мәнді қайтарады.
Ең аз Әрбір қолданған деректер түрі өрнектерінің тізімінен, ең кіші мәнді қайтарады.
numbertostring функциясы Қалқыма немесе бүтін сан өрнегін, көрсетілген бүркенішті қолдана отыра, жол өрнегіне түрлендіреді.
қайталау Уақыт санын көрсететін басқа жол арқылы жолды құрады.
strins Көрсетілген орында бір жолды басқа жолға кірістіреді.
strloc Жолдағы ішкі жолдың бастау орнын қайтарады. Егер ішкі жол табылмаса, функция нөльге айналады.
stringtotime Жол өрнегін, көрсетілген бүркенішті қолдана отыра, уақыт өрнегіне түрлендіреді.
substitute Жолда, бір ішкі жолды басқа жолмен орнын ауыстырады.
substr Көрсетілген бастау орны мен ұзындығы берілген ішкі жолды қайтарады.
timetostring Уақыт өрнегін, көрсетілген бүркенішті қолдана отыра, жол өрнегіне түрлендіреді.
translate Таңбалардың орнын жолға ауыстырады.
xmlencode XML өрісін, жол өрнегіне түрлендіреді.
xmldecode Жол өрнегін, XML өрісіне түрлендіреді.

алтылық

Бұл функция, ASCII жолына оналтылық таңба кодының жол литералын аударады. Алтылық функциясы әртүрлі таңбаларды көрсете алады, сондықтан әдетте оны қойынша сияқты ASCII көрінісі жоқ таңбаларға қолданасыз.

Әрбір екі алтылық сан, нәтиже жолында бір таңбаны ұсынады. Жол литералындағы алтылық таңбаның тақ саны қатеге алып келеді. Келесі синтаксисті пайдаланыңыз:
алтылық (hex_codes)
мұндағы hex_codes мәні, құрамында таңбалар мен таңбалар қатарының алтылық коды бар жол литералы.
Келесі мысал жолды қайтарады abc өйткені 61, 62, және 63 сандары, сол таңбалардың оналтылық коды.
алтылық ("616263")

аудару

Бұл функция, көрсеткен таңбалармен бір жолдағы таңбалардың орнын ауыстыру арқылы жаңа жолды құрады. Аудару функциясы, таңбаларды кодтау үшін пайдалы.

Келесі синтаксисті пайдаланыңыз:
аудару (source_string, search_string,
replace_string)
мұнда:
Кесте 2. Аудару функциясы үшін параметрлер мен сипаттама
Параметр Сипаттама
source_string Құрамында таңбалары бар жолдың орны ауыстырылады.
search_string source_string функциясындағы таңбалар жолының орнын ауыстыру. replace_string сияқты бірдей ұзындықта болуы керек.
replace_string Орнын ауыстыратын таңбалардың жолы. search_string сияқты бірдей ұзындықта болуы керек.

Әрбір таңбалардың негізінде іздеу-және-орын ауыстыру пайда болады. Егер іздеу жолы "abc" және орнын ауыстыру жолы "def" болса, функция "a" to "d", "b" "e", және "c" to "f" әріптерін жақында құрылған жолға аударады.

Мысалы, келесі мәндермен,
source_string құрамында "*123-#44-!999" бар
search_string құрамында "#*!-" бар
replace_string құрамында "XYZ&" бар
функция келесі жаңа жолды шығарады:
Y123&X44&Z999

Қайнар көз жолының, іздеу жолы және орнын ауыстыру жолының мазмұндары өзгермейтінін ескеріңіз.

Кеңес: Жеке таңбаларға қарағанда, ішкі жолдың толық орнын ауыстыру және іздеу үшін, орын басушы функциясын қолданыңыз.
Келесі мысал аудару функциясын, Еуропалық сан пішімінен Америкалық сан пішіміне, жолды түрлендіру үшін қолданады.
аудару (str, ".,", ",.")

кіші, бас

Бұл функциялар, жолдағы барлық таңбаларды кіші- немесе бас- әріптерге түрлендіруі тиіс. Келесі синтаксисті пайдаланыңыз:
кіші (string_exp)

бас (string_exp)
мұндағы string_exp мәні, түрлендіретін жол өрнегі.

in_set

Егер алғашқы жолдағы әрбір таңба, екінші жолдағы бір жерінде болса, дұрыс логикалық мәнді қайтара отыра, бұл функция екі жолды салыстырады. Егер алғашқы жолдың құрамында екінші жолдың құрамында жоқ кем дегенде бір таңба болса, функция қате мәнді қайтарады. Таңбалар екі жолдағы бірдей ретте пайда болғанды қажет етпейді; сонымен қатар, екінші жолда қосымша таңбалар болады.

Келесі синтаксисті пайдаланыңыз:
in_set (subset_string, superset_string)
мұнда:
Кесте 3. in_set функциясы үшін параметрлер мен сипаттама
Параметр Сипаттама
subset_string Жол өрнегінің құрамында тек қана жиын таңбалары болады.
superset_string subset_string мәніне салыстырылған жол өрнегі.
Келесі мысалда,
in_set (атауы, "abcdefghijklmnopqrstuvwxyz")
функция дұрысты қайтарады, егер
атауы = "jim"
бірақ қате болса, егер
атауы = "Fido"
немесе
атауы = "a.b"

ұзындық болса

Бұл функция жол өрнегінің (жарияланбаған) нақты ұзындығын есептейді. Бұл өрнекте, аймақты қоса таңбалардың толық санын береді. Келесі синтаксисті пайдаланыңыз:
ұзындық (string_expr)
мұндағы string_expr мәні, есептелетін ұзындығы бар жол өрнегі болып табылады.
Келесі мысалда, қайтарылған ұзындық 15 болады. Жабық тырнақшалар таңбалар ретінде есептелмейді.
ұзындық ("Hamilton Burger")

қайталау

Бұл функция, уақыт санын көрсеткен берілген жолды қайталау арқылы жолды құрады. Келесі синтаксисті пайдаланыңыз:
қайталау (string_expr, repeat_num)
мұнда:
Кесте 4. Қайталау функциясы үшін параметрлер мен сипаттама
Параметр Сипаттама
string_expr Қайталанатын жол өрнегі.
repeat_num string_exp функциясын қайталау үшін уақыт саны.
Келесі мысал abcdabcdabcdabcdabcd жолын шығарады.
қайталау ("abcd", 5)

strloc

Ішкі жол, қайнар көз жолдың бөлігі; ол қайнар көз жолдың ұзындығына тең немесе одан кем болуы мүмкін. Мысалы, Good, Morn, od Morni, және Good Morni барлығы Good Morning мәнінің ішкі жолдары.

strloc функциясын, нақты ішкі жолдың, қайнар көздің қай жерінде пайда болғанын табу үшін қолданыңыз. Бұл функция қайнар көз жолдағы ішкі жолдың бастау таңбаларының орнын қайтарады.

Егер ішкі жол, қайнар көз жолда бірнеше рет табылса, онда функция оның алғашқы пайда болуының бастау орнын қайтарады. Егер ішкі жол табылмаса немесе ішкі жол қайнар көз жолға қарағанда ұзынырақ болса, функция нөлді қайтарады.

Келесі синтаксисті пайдаланыңыз:
strloc (source_string, sub_string)
мұнда:
Кесте 5. strloc функциясы үшін параметрлер мен сипаттама
Параметр Сипаттама
source_string Ішкі жол ізделетін жол.
sub_string Іздеу үшін жол.
Бұл мысал 6 мәнін қайтарады өйткені ішкі жол, қайнар көз жолдың 6 орнында басталады.
strloc ("Good Morning", "Morning")

substr

Бұл функция ішкі жолды, қайнар көз жолдан шығарып алып, жаңа жол құрады. Шығарып алу басталатын жерде қайнар көз жолын және таңба орнын көрсетесіз. Қосымша, шығарып алынатын таңбалардың санын қолдану міндетті емес; егер бұл мәліметті алмасаңыз, шығарып алу қайнар көз жолының соңында тоқтап қалады.

Келесі синтаксисті пайдаланыңыз:
substr (source_string, start_pos {, length})
мұнда:
Кесте 6. substr функциясы үшін параметрлер мен сипаттама
Параметр Сипаттама
source_string Қайнар көз жолы.
start_pos Шығарып алу басталатын таңба орны.
ұзындық Шығарып алынатын таңбалардың саны (мысалы, шығарып алынған жолдың ұзындығы).
Келесі мысал, Morning жолын қайтарады. Жабық тырнақшалар жолдың бөлігі ретінде саналмайды.
substr ("Good Morning!", 6, 7)

Бұл функция, жолдың ұзындығына қарағанда бірнеше орындық жолдың нөл ұзындығын(тырнақшалар арасындағы таңбалары жоқ жолдар) шығарып алады. Бұл пайдалану, шарт қыры сияқты нөл ұзындықты жолдары бар алгоритмге пайдалы. Таңбаларды 1 орнынан +1 жолының соңғы таңбасы арасына шығарып аласыз; сондықтан, 1-орындары және +1 жолының ұзындығы қыр шарттары болып табылады.

Орындалу уақытының қателігі пайда болады егер:

  • Бастау орныңыз 1-ден кем немесе + 1 қайнар көз жолының ұзындығынан үлкен болса.
  • Көрсетілген ұзындық, қайнар көз жолындағы қалдық таңбаларға қарағанда, ұзын болатын ішкі жолды жасайды (ол, start_pos + ұзындық > ұзындыұ (source_string) + 1).

strins

Бұл функция бір жолды басқа жолға кірістіріп, жаңа жол құрады. Қайнар көз жолының және кірістіру жолының мәндері өзгермейді. Келесі синтаксисті пайдаланыңыз:
strins (source_string, insert_string, start_pos)
мұнда:
Кесте 7. strins функциясы үшін параметрлер мен сипаттама
Параметр Сипаттама
source_string Жаңа жолды жасау үшін, жол insert_string функциясымен біріктіріледі.
insert_string Жаңа жолды жасау үшін, жол source_string функциясымен біріктіріледі.
start_pos

Кірістіру басталатын source_string функциясындағы орын; мән 1-ден source_string + 1 ұзындығына созылады.

Егер 1-ден кем немесе source_string + 1-ден үлкен мәнді көрсетсеңіз, орындалу уақытының қателігі пайда болады.

Төменде көрсетілген мысалда, келесіні қабылдаңыз
insert_str = "Mr. Jones,"
және соны
source_str = "Good morning, what a lovely day."
strins (source_str, insert_str, 15)
Жоғарыда көрсетілген мәндермен, функция келесі жолды қайтарады:
Good morning, Mr. Jones, what a lovely day.

орын басушы

Бұл функция, ішіндегі басқа көрсетілген қайнар көз жолымен бір ішкі жолдың орнын ауыстыру арқылы жаңа жол құрады. Келесі синтаксисті пайдаланыңыз:
орын басушы (source_string, unwanted_string,
replacement_string)
мұнда:
Кесте 8. Орын басушы функциясы үшін параметрлер мен сипаттама
Параметр Сипаттама
source_string Құрамында unwanted_string функциясы бар жол.
unwanted_string source_string функциясының ішкі жолы.
replacement_string Жаңа жол құру үшін, unwanted_string функциясының орын ауыстыратын жол.
Келесі мысалда, abc мәнінің әрбір пайда болуы TestString ішінде, wxyz мәнімен орнын ауыстырады. Орын ауыстыру сол жағынан оң жаққа қарай пайда болады.
орын басушы (TestString, "abc", "wxyz")
Егер
TestString = "abcdabcd"
функция келесі жаңа жолды қайтарады:
wxyzdwxyzd
Қайнар көз жолының, керексіз жолдың, және орын ауыстыру жолының мазмұны өзгермейді.
Кеңес: Ішкі жолға қарағанда, жеке таңбаларды іздеу және орын ауыстыру үшін, аудару функциясын қолданыңыз.

ltrim, rtrim, және trim

Бұл функциялар жаңа жолды, жаңа жолдың (trim) екі соңын немесе (rtrim) соңын, (ltrim) бастауынан көрсетілген таңбаларды немесе бос орындарды жою және бар қайнар көз жолын көшіру арқылы құрады. Барлық жағдайда, қайнар көз жолы өзгертусіз қалады.

Келесі синтаксисті барлық үш функцияға қолданыңыз:
ltrim (string_expr{, trim_char}opt)

rtrim (string_expr{, trim_char}opt)

trim (string_expr{, trim_char}opt)
мұнда:
Кесте 9. trim, ltrim және rtrim функциялары үшін параметрлер мен сипаттама
Параметр Сипаттама
string_expr Көшіру үшін қайнар көз жолының өрнегі.
trim_char

Жаңа жолдан жойылатын таңбаларды көрсететін міндетті емес параметрлер. Егер бұл параметрді көрсетпесеңіз, бос орындар жойылады.

Функцияға байланысты, жаңа жолдың соңы немесе екі соңынан жою немесе бастау басталады және trim_char функциясында көрсетілмеген таңбасы табылғанға дейін (немесе бос орынды емес таңба) жалғасады.

Келесі мысал, LastName функциясынан барлық басы бойынша бос орындарды жояды. Мысалда,
LastName = "Smith"
және қайтарылған жаңа жол
"Smith"
ltrim (LastName)
Төмендегі мысал, & Status деп аталатын жолдың соңынан таңбаны жояды. Егер
Status = "OpenXY&Z&&&&"
қайтарылған жаңа жол
"OpenXY&Z"
rtrim (Status, "&")
Келесі мысал, барлық соңы бойынша сандарды, AccountName функциясынан жояды.
rtrim (AccountName, "0123456789")

is_number

Бұл функция, көрсетілген жол өрнегі не қалқымаға немесе бүтін сан мәніне есептелетінін анықтайды. егер түгел жол (тек қана ішкі жол емес) қалқымаға немесе бүтін санға есептелсе және кері жағдайда қатеге есептелсе, is_number функциясы дұрыс логикалық мәнді қайтарады.

Келесі синтаксисті пайдаланыңыз:
is_number (expr)
мұндағы expr мәні - жол өрнегі.
Келесі үш мысал дұрыс, қате және тиісті қатені қайтарады.
is_number ("123.4")

is_number ("no")

is_number ("abc63j")

is_time

Бұл функция көрсетілген жол өрнегінің, көрсетілген пішімнің уақыт мәніне есептелетінін анықтайды. is_time функциясы дұрыс логикалық мәнді қайтарады, егер түгел жол (тек қана ішкі жол емес) көрсетілгендей пішімделген уақытқа есептелсе; кері жағдайда, функция қате мәнді қайтарады.

Келесі синтаксисті пайдаланыңыз:
is_time (str_expr, date_time_mask)
мұнда:
Кесте 10. is_time функциясы үшін параметрлер мен сипаттама
Параметр Сипаттама
str_expr Жол өрнегі.
date_time_mask Дұрыс мәнді қайтару үшін is_time функциясының орнына str_expr функциясын қолданатынын күн/уақыт бүркеніші функциясы көрсетеді.
Келесі мысалдарда, алғашқы мысал қатені қайтарады және екінші мысал дұрысты қайтарады. Екі мысалда, түрлендіру функциясы, is_time функциясы есептелетіндей уақыт дерегінің түріне, жол өрнегін түрлендіру үшін қолданылады.
is_time ("nov121995", "mm/dd/yyyy")

is_time ("11/12/1995", "mm/dd/yyyy")

timetostring

Бұл функция, көрсеткен пішімді қолдана отыра, уақыт өрнегін жол өрнегіне түрлендіреді. Келесі синтаксисті пайдаланыңыз:
timetostring (time_expr, date_time_mask)
мұнда:
Кесте 11. timetostring функциясы үшін параметрлер мен сипаттама
Параметр Сипаттама
time_expr Түр уақытының өрнегі.
date_time_mask күн/уақыт бүркеніші функциясы, timetostring функциясының шығару пішімін анықтайды.
Келесі мысал, жүйе уақытын жолға түрлендіреді. Көрсетілген күн/уақыт бүркенішін қолдана отыра пішімделген жол.
timetostring (systemtime(), "mm/dd/yyyy hh:tt:ss am")
Жоғарыдағы мысалда, егер systemtime() 1985 жылдың 1-Шілдесінің, 12:45-тен 6 секунд өткендегі уақытқа эквивалент болса, жол шығаруы:
7/1/1985 12:45:06 pm

systemtime() функциясы туралы мәліметті қараңыз.

уақытқа қарай жол

Бұл функция, көрсеткен пішімді қолдана отыра, жолды уақытқа түрлендіреді. Келесі синтаксисті пайдаланыңыз:
stringtotime (string_expr, date_time_mask)
мұнда:
Кесте 12. stringtotime функциясы үшін параметрлер мен сипаттама
Параметр Сипаттама
string_expr Түр жолының өрнегі.
date_time_mask күн/уақыт бүркеніші түрлендіруге қолдану үшін уақыт пішімін көрсетеді.
Келесі мысалда, HostTime - жол айнымалы мәні.
stringtotime (HostTime, "mon. dd, yyyy hh:tt:ss am")
If
HostTime = "Jul. 1, 1985 12:45:06 pm"
онда нәтиже шығару, 1985 жылдың 1-Шілдесіндегі, 12:45-ден 6 секунд өткендегі мәнге эквивалентті уақыт мәні болады.

кодтау, кодсыздандыру

Бұл функция, мазмұндарды кеңейту мақсаты үшін мағынасыз жолға, жолды түрлендіреді. Кодтау және кодсыздандыру екеуіде бірдей жұмыс прцессінде болуы керек.

Кодсыздандыру функциясы, құрамында бірнеше кодтау жолдары бар жол өрнегін түрлендіру үшін қолданылады.
кодтау (string_expr)

кодсыздандыру (string_expr)
мұнда:
Кесте 13. Кодтау және кодсыздандыру функциясы үшін параметрлер мен сипаттама
Параметр Сипаттама
string_expr Түр жолының өрнегі. Жол - литерал болмайды.


Last updated: March 2016
bpfe012.htm

© IBM корпорациясының авторлық құқықтары 2016.