The Ring programming language version 1.8 book - Part 116 of 202
0 likes12 views
The FoxRing functions documentation describes a collection of functions written to emulate commonly used functions from the FoxPro programming language, with each function defined including its syntax, description, arguments, and return values. Some of the key functions covered include frAbs() for getting the absolute value, frAt() and frAtC() for searching strings, frChr() for getting the character of an ASCII code, and frEmpty() to check if a value is empty.
![CHAPTER
EIGHTYTHREE
RINGMURMURHASH FUNCTIONS REFERENCE
â MurmurHash is a non-cryptographic hash function suitable for general hash-based lookup. It was created by
Austin Appleby in 2008 and is currently hosted on Github along with its test suite named âSMHasherâ. It also
exists in a number of variants,[5] all of which have been released into the public domain. The name comes from
two basic operations, multiply (MU) and rotate (R), used in its inner loop. â
Murmurhash extension is an extension written to implement a full implementation for the MurmurHash library.
Developer: Hassan Ahmed
83.1 MurmurHash1 functions
uint32_t murmurhash1(string key, int seed, [bool return_type]);
uint32_t murmurhash1_aligned(string key, int seed, [bool return_type]);
83.2 MurmurHash2 functions
uint32_t murmurhash2(string key, int seed, [bool return_type]);
uint32_t murmurhash2a(string key, int seed, [bool return_type]);
uint64_t murmurhash64a(string key, int seed, [bool return_type]);
uint64_t murmurhash64b(string key, int seed, [bool return_type]);
uint32_t murmurhash_neutral2(string key, int seed, [bool return_type]);
uint32_t murmurhash_aligned2(string key, int seed, [bool return_type]);
83.3 MurmurHash3 functions
uint32_t murmurhash3_x86_32(string key, int seed, [bool return_type]);
list murmurhash3_x86_128(string key, int seed, [bool return_type]);
list murmurhash3_x64_128(string key, int seed, [bool return_type]);
The third optional parameter is to set the type of the returned value, this parameter accepts a bool value [ true, false ],
true will return a Hex value, while false will return a integer value.
1125](https://image.slidesharecdn.com/1151ring-180829123245/85/The-Ring-programming-language-version-1-8-book-Part-116-of-202-5-320.jpg)
The Ring programming language version 1.8 book - Part 116 of 202
- 1. Ring Documentation, Release 1.8 82.207 QXmlStreamEntityResolver Class C++ Reference : http://doc.qt.io/qt-5/QXmlStreamEntityResolver.html Parameters : void 82.208 QXmlStreamNamespaceDeclaration Class C++ Reference : http://doc.qt.io/qt-5/QXmlStreamNamespaceDeclaration.html Parameters : void âą QStringRef namespaceUri(void) âą QStringRef preïŹx(void) 82.209 QXmlStreamNotationDeclaration Class C++ Reference : http://doc.qt.io/qt-5/QXmlStreamNotationDeclaration.html Parameters : void âą QStringRef name(void) âą QStringRef publicId(void) âą QStringRef systemId(void) 82.210 QXmlStreamReader Class C++ Reference : http://doc.qt.io/qt-5/QXmlStreamReader.html Parameters : void âą void addData(QByteArray) âą void addData_2(QString) âą void addData_3(const char * data) âą void addExtraNamespaceDeclaration(QXmlStreamNamespaceDeclaration) âą void addExtraNamespaceDeclarations(QXmlStreamNamespaceDeclarations) âą bool atEnd(void) âą QXmlStreamAttributes attributes(void) âą qint64 characterOffset(void) âą void clear(void) âą qint64 columnNumber(void) âą QIODevice *device(void) âą QStringRef documentEncoding(void) âą QStringRef documentVersion(void) 82.207. QXmlStreamEntityResolver Class 1121
- 2. Ring Documentation, Release 1.8 âą QStringRef dtdName(void) âą QStringRef dtdPublicId(void) âą QStringRef dtdSystemId(void) âą QXmlStreamEntityDeclarations entityDeclarations(void) âą QXmlStreamEntityResolver *entityResolver(void) âą Error error(void) âą QString errorString(void) âą bool hasError(void) âą bool isCDATA(void) âą bool isCharacters(void) âą bool isComment(void) âą bool isDTD(void) âą bool isEndDocument(void) âą bool isEndElement(void) âą bool isEntityReference(void) âą bool isProcessingInstruction(void) âą bool isStandaloneDocument(void) âą bool isStartDocument(void) âą bool isStartElement(void) âą bool isWhitespace(void) âą qint64 lineNumber(void) âą QStringRef name(void) âą QXmlStreamNamespaceDeclarations namespaceDeclarations(void) âą bool namespaceProcessing(void) âą QStringRef namespaceUri(void) âą QXmlStreamNotationDeclarations notationDeclarations(void) âą QStringRef preïŹx(void) âą QStringRef processingInstructionData(void) âą QStringRef processingInstructionTarget(void) âą QStringRef qualiïŹedName(void) âą void raiseError(QString) âą QString readElementText(QXmlStreamReader::ReadElementTextBehaviour) âą TokenType readNext(void) âą bool readNextStartElement(void) âą void setDevice(QIODevice *device) âą void setEntityResolver(QXmlStreamEntityResolver *resolver) 82.210. QXmlStreamReader Class 1122
- 3. Ring Documentation, Release 1.8 âą void setNamespaceProcessing(bool) âą void skipCurrentElement(void) âą QStringRef text(void) âą QString tokenString(void) âą TokenType tokenType(void) 82.211 QXmlStreamWriter Class C++ Reference : http://doc.qt.io/qt-5/QXmlStreamWriter.html Parameters : void âą bool autoFormatting(void) âą int autoFormattingIndent(void) âą QTextCodec *codec(void) âą QIODevice *device(void) âą bool hasError(void) âą void setAutoFormatting(bool enable) âą void setAutoFormattingIndent(int spacesOrTabs) âą void setCodec(QTextCodec *codec) âą void setCodec_2(const char *codecName) âą void setDevice(QIODevice *device) âą void writeAttribute(QString, QString,QString) âą void writeAttribute_2(QString, QString) âą void writeAttribute_3(QXmlStreamAttribute) âą void writeAttributes(QXmlStreamAttributes) âą void writeCDATA(QString text) âą void writeCharacters(QString text) âą void writeComment(QString text) âą void writeCurrentToken(QXmlStreamReader reader) âą void writeDTD(QString dtd) âą void writeDefaultNamespace(QString namespaceUri) âą void writeEmptyElement(QString namespaceUri, QString name) âą void writeEmptyElement_2(QString qualiïŹedName) âą void writeEndDocument(void) âą void writeEndElement(void) âą void writeEntityReference(QString name) âą void writeNamespace(QString namespaceUri, QString preïŹx) 82.211. QXmlStreamWriter Class 1123
- 4. Ring Documentation, Release 1.8 âą void writeProcessingInstruction(QString target, QString data) âą void writeStartDocument(QString version) âą void writeStartDocument_2(QString version, bool standalone) âą void writeStartDocument_3(void) âą void writeStartElement(QString namespaceUri, QString name) âą void writeStartElement_2(QString qualiïŹedName) âą void writeTextElement(QString namespaceUri, QString name, QString text) âą void writeTextElement_2(QString qualiïŹedName, QString text) 82.212 RingCodeHighlighter Class Parameters : QTextDocument *parent âą void setColors(QColor c1,QColor c2,QColor c3,QColor c4,QColor c5) âą void setKeywordsBold(int nStatus) 82.212. RingCodeHighlighter Class 1124
- 5. CHAPTER EIGHTYTHREE RINGMURMURHASH FUNCTIONS REFERENCE â MurmurHash is a non-cryptographic hash function suitable for general hash-based lookup. It was created by Austin Appleby in 2008 and is currently hosted on Github along with its test suite named âSMHasherâ. It also exists in a number of variants,[5] all of which have been released into the public domain. The name comes from two basic operations, multiply (MU) and rotate (R), used in its inner loop. â Murmurhash extension is an extension written to implement a full implementation for the MurmurHash library. Developer: Hassan Ahmed 83.1 MurmurHash1 functions uint32_t murmurhash1(string key, int seed, [bool return_type]); uint32_t murmurhash1_aligned(string key, int seed, [bool return_type]); 83.2 MurmurHash2 functions uint32_t murmurhash2(string key, int seed, [bool return_type]); uint32_t murmurhash2a(string key, int seed, [bool return_type]); uint64_t murmurhash64a(string key, int seed, [bool return_type]); uint64_t murmurhash64b(string key, int seed, [bool return_type]); uint32_t murmurhash_neutral2(string key, int seed, [bool return_type]); uint32_t murmurhash_aligned2(string key, int seed, [bool return_type]); 83.3 MurmurHash3 functions uint32_t murmurhash3_x86_32(string key, int seed, [bool return_type]); list murmurhash3_x86_128(string key, int seed, [bool return_type]); list murmurhash3_x64_128(string key, int seed, [bool return_type]); The third optional parameter is to set the type of the returned value, this parameter accepts a bool value [ true, false ], true will return a Hex value, while false will return a integer value. 1125
- 6. Ring Documentation, Release 1.8 83.4 Example load "murmurhashlib.ring" key = "Ring Language" see murmurhash3_x86_32(key, 0, 0) + nl // Output: 1894444853 see murmurhash3_x86_32(key, 0, 1) + nl // Output: 70eaef35 83.4. Example 1126
- 7. CHAPTER EIGHTYFOUR FOXRING FUNCTIONS REFERENCE As a FoxPro developer, I started writing a class with some of the functions I used in FoxPro. The goal is to create as many functions as possible with the behavior similar to FoxPro functions. Developer: Jose Rosado 84.1 FoxRing functions Function Name Description frAbs() Returns the absolute value of the speciïŹed numeric expression. frAddBs() Adds a backslash (if needed) to a path expression. frALines() Creates an Array with the content of the speciïŹed string. frAllTrim() Removes all leading and trailing spaces of the speciïŹed string. frAsc() Returns the ANSI value for the leftmost character in a character expression. frAt() Searches a character expression for the occurrence of another character expression. frAtC() Searches a character expression for the ocurrence of another character expression without regard for the case of these two expressions. frBetween() Determines whether the value of an expression is inclusively between the values of two expressions of the same type. frChr() Returns the character associated with the speciïŹed numeric ANSI code. frEmpty() Determines whether an expression evaluates to empty. frFile() Checks if a ïŹle exists on disk. frFileToStr() Returns the contents of a ïŹle as a character string. frForceExt() Returns a string with the old ïŹle name extension replaced by a new extension. frForcePath() Returns a ïŹle name with a new path name substituted for the old one. frIif() Returns one of two values depending on the value of a logical expression. frInList() Determines whether an expression matches another expression in a list. frInt() Evaluates a numeric expression and returns the integer portion of the expression. frJustDrive() Returns the drive letter from a complete path. frJustExt() Returns the characters of a ïŹle extension from a complete path. frJustFName() Returns the ïŹle name portion of a complete path and ïŹle name. frJustPath() Returns the path portion of a complete path and ïŹle name. frJustStem() Returns the stem name (the ïŹle name before the extension) from a complete path and ïŹle name. frLen() Determines the number of characters in a character expression, indicating the length of the expression. Continued on next page 1127
- 8. Ring Documentation, Release 1.8 Table 84.1 â continued from previous page Function Name Description frListToString() Creates a string with the string elements of an Array. frLTrim() Removes all leading spaces or parsing characters from the speciïŹed character expression. frPadL() Returns a string from an expression, padded with spaces or characters to a speciïŹed length on the left side. frPadR() Returns a string from an expression, padded with spaces or characters to a speciïŹed length on the right side. frProper() Returns from a character expression a string capitalized as appropriate for proper names. frReplicate() Returns a character string that contains a speciïŹed character expression repeated a speciïŹed number of times. frRTrim() Removes all trailing spaces or parsing characters from the speciïŹed character expression. frSetIfEmpty() Set a Value into a variable if the variable value is empty, null or zero. frSetSeparatorTo() SpeciïŹes the character for the numeric place separator. frSpace() Returns a character string composed of a speciïŹed number of spaces. frStr() Returns the character equivalent of a numeric expression. frStringToList() Creates a List with the content of the speciïŹed string. frStrTran() Searches a character expression for a second character expression and replaces each occurrence with a third character expression. frStuff() Returns a new character string replaced by a speciïŹed number of characteres in a character expression with another character expression. frSubStr() Returns a character string from the given character expression, starting at a speciïŹed position in the character expression and continuing for a speciïŹed number of characters. frTransform() Returns a character string from an expression in a format determined by a format code. frVal() Returns a numeric value from a character expression composed of numbers. frVarType() Returns the data type of an expression. 84.2 frAbs() function * Syntax : lnReturnValue = frAbs(tnExpression) * Description : Returns the absolute value of the specified numeric expression. * : * Arguments : <tnExpression> * : Specifies the numeric expression whose absolute value frAbs() * : returns. * Returns : <lnReturnValue> * : Returns the absolute value of the specified numeric expression. 84.3 frAsc() function * Syntax : lnReturnValue = frAsc(tcExpression) * Description : Returns the ANSI value for the leftmost character in * : a character expression. * Arguments : <tcExpression> * : Specifies the character expression containing the character 84.2. frAbs() function 1128
- 9. Ring Documentation, Release 1.8 * : whose ANSI value frAsc() * : returns. Any characters after the first character in * : tcExpression are ignored by frAsc(). * Returns : <lnReturnValue> * : returns the position of the character in the character * : table of the current code page. * : Every character has a unique ANSI value in the * : range from 0 to 255. 84.4 frAddBs() function * Syntax : lcReturnValue = frAddBs(tcPath) * Description : Adds a backslash (if needed) to a path expression. * : * Arguments : <tcPath> * : Specifies the path name to which to add the backslash. * : * Returns : <lcReturnValue> The path with the backslash. 84.5 frAt() function * Syntax : lnPos = frAt(tcToSearch, tcString, tnOccurrence) * Description : Searches a character expression for the occurrence of * : another character expression. * : The search performed by frAt() is case-sensitive. * : * Arguments : <tcToSearch> * : Specifies the character expression to search * : for in <tcString>. * : <tcString> * : Specifies the character expression to search * : for <tcToSearch>. * : <tnOccurrence> * : Specifies which occurrence, first, second, third, * : and so on, of <tcToSearch> to search for * : in <tcString>. * : By default, frAt() searches for the first occurrence * : of <tcToSearch> (tnOccurrence = 1). * Returns : Numeric. frAt() returns an integer indicating the * : position of the first character for a * : character expression or memo field within another * : character expression or memo field, * : beginning from the leftmost character. If the * : expression or field is not found, or if * : <tnOccurrence> is greater than the number of * : times <tcToSearch> occurs in <tcString>, frAt() * : returns 0. 84.4. frAddBs() function 1129
- 10. Ring Documentation, Release 1.8 84.6 frAtC() function * Syntax : lnPos = frAtC(tcToSearch, tcString, tnOccurrence) * Description : Searches a character expression for the occurrence * : of another character expression * : without regard for the case of these two expressions. * : * Arguments : <tcToSearch> * : Specifies the character expression to search * : for in <tcString>. * : <tcString> * : Specifies the character expression to search * : for <tcToSearch>. * : <tnOccurrence> * : Specifies which occurrence, first, second, third, * : and so on, of <tcToSearch> to search for * : in tcString. * : By default, frAtC() searches for the first occurrence * : of <tcToSearch> (tnOccurrence = 1). * Returns : Numeric. frAtC() returns an integer indicating the * : position of the first character for a * : character expression or memo field within * : another character expression or memo field, * : beginning from the leftmost character. If the * : expression or field is not found, or if * : <tnOccurrence> is greater than the number of * : times <tcToSearch> occurs in <tcString>, frAtC() * : returns 0. 84.7 frChr() function * Syntax : lcReturnValue = frChr(tnExpression) * Description : Returns the character associated with the specified numeric * : ANSI code. * Arguments : <tnExpression> * : Specifies a number between 0 and 255 whose equivalent ANSI * : character frChr() returns. * Returns : <lcReturnValue> * : Returns a single character corresponding to the numeric * : position of the character in the * : character table of the current code page. * : * Remarks : tnExpression must be between 0 and 255 84.8 frEmpty() function * Syntax : llReturnValue = frEmpty(tuExpression) * Description : Determines whether an expression evaluates to empty. * : * Arguments : <tuExpression> * : Specifies the expression that EMPTY() evaluates. * : You can specify an expression with Character, * : Numeric, or logical type. 84.6. frAtC() function 1130