hb_U - Petewg/harbour-core GitHub Wiki

🔙 Home

• hb_UAt( <cSubString>, <cString>, [<nFrom>], [<nTo>] ) ➜ nAt
  Unicode counterpart of 'hb_At()'.

• hb_UChar( <nCode> ) ➜ cText
  return string with U+nCode character in HVM CP encoding.

• hb_UCode( <cText> ) ➜ nCode
  return Unicode value of 1-st character (not byte) in given string. Similar to 'hb_UTF8Asc()'.

• hb_ULen( <cText> ) ➜ nChars
  returns the length of unicode string <cText>, in characters.

• hb_ULeft( <cString>, <nCount> ) ➜ cSubstring
  same as 'Left()' but applicable to UTF8 encoded text.

• hb_UPadC(<exp>, <nLength>, [<cFillChar>]) ➜ cPaddedString
  same as 'PadC()' but Unicode oriented.

• hb_UPadL(<exp>, <nLength>, [<cFillChar>]) ➜ cPaddedString same as 'PadL()' but Unicode oriented.

• hb_UPadR(<exp>, <nLength>, [<cFillChar>]) ➜ cPaddedString
  same as 'PadR()' but Unicode oriented.

• hb_UPeek( <cText>, <n> ) ➜ nCode
  return unicode value of <n>-th character in given string

• hb_UPoke( [@]<cText>, <n>, <nVal> ) ➜ cText
  change <n>-th character in given string to unicode <nVal> one and return modified text.

• hb_URight( <cString>, <nCount> ) ➜ cSubstring

• hb_UserLang() ➜ cOSLangName
  returns system's (OS) language name identifier, for the current user, in the form "ll[-SS]" where ll is language and SS sublanguage identifier. (f.e.: en-US, fr-BE, el-GR etc ). Should not be confused with the value returned by 'hb_langSelect()', albeit they may coincide.

• hb_UserName() ➜ cOSUserName
  returns OS Logon user name.

• hb_UStuff( <cString>, <nAt>, <nDel>, <cIns> ) ➜ cResult
  Unicode counterpart of 'Staff()'.

• hb_USubStr( <cString>, <nStart>, <nCount> ) ➜ cSubstring
  Unicode counterpart of 'SubStr()'.

• hb_UTCOffset( [<tLocalTime>] ) ➜ nSeconds
  returns the UTC offset as a signed number of seconds.

• hb_utf8Asc( <cExp> ) ➜ nUTF8CharCode
  same as 'Asc()' but applicable to UTF8 encoded text. Similar to 'hb_UCode()'.

• hb_utf8At(<...>) ➜ nPos
  same as hb_At() but applicable to UTF8 encoded text.

• hb_utf8Chr( <n> ) ➜ cUTF8Char
  same as 'Chr()' but applicable to UTF8 encoded text.

• hb_utf8Left(...) ➜ cString
  same as 'Left()' but applicable to UTF8 encoded text.

• hb_utf8Len(`' ) ➜ nLen same as 'Len()' but applicable to UTF8 encoded text.

• hb_utf8Peek( <cText>, <n> ) ➜ nCode
  return UTF8 value of <n>-th character in given string.

• hb_utf8Poke( [@]<cText>, <n>, <nVal> ) ➜ cText
  replace <n>-th character in given string to UTF8 <nVal> one and return modified text.

• hb_utf8RAt() ➜ nPos
  same as 'hb_RAt()' but applicable to UTF8 encoded text.

• hb_utf8Right() ➜ nPos
  same as 'Right()' but applicable to UTF8 encoded text.

• hb_utf8StrTran() ➜ cString
  same as 'StrTran()' but applicable to UTF8 encoded text.

• hb_utf8Stuff() ➜ cString
  same as 'Stuff()' but applicable to UTF8 encoded text.

• hb_utf8SubStr() ➜ cString
  same as 'SubStr()' but applicable to UTF8 encoded text.

• hb_utf8ToStr(<cUTF8Str> [, <cCPID>]) ➜ cStr
  it performs "translation" from UTF-8 to <cCPID> Harbour codepage id, f.e.: "EN", "ES", "ESWIN" etc.
  <cUTF8Str> supposed to be a UTF-8 encoded string.
  When <cCPID> is not given then the default HVM codepage (i.e. that set by hb_cdpSelect()) is used.

• hb_UTF8ToStrBox(<cUTF8String>) ➜ <cBoxCharsStringEncodedIn_GT_BOXCP
  returns a string consisted of box characters, trans-coded from UTF-8 to GT_BOXCP code-page, which may differ from the main code-page. In other words, this is a trans-code function specific to 'Box characters', needed because hb_utf8ToStr() (see above) will convert the given UTF-8 string to main or given code-page, while the code-page of box drawing characters might have been setup differently, with HB_GTI_BOXCP (see hb_gtInfo() function). This function will take into account that setting, which may or may not be the same as the main used code-page.

🔙 Home