chore(ArduinoAPI): update code style to webkit

Author: FASTSHIFT

Keilduino/ArduinoAPI/WCharacter.h

@@ -1,24 +1,23 @@
-/*
- WCharacter.h - Character utility functions for Wiring & Arduino
- Copyright (c) 2010 Hernando Barragan.  All right reserved.
- 
- This library is free software; you can redistribute it and/or
- modify it under the terms of the GNU Lesser General Public
- License as published by the Free Software Foundation; either
- version 2.1 of the License, or (at your option) any later version.
- 
- This library is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
- Lesser General Public License for more details.
- 
- You should have received a copy of the GNU Lesser General Public
- License along with this library; if not, write to the Free Software
- Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+/**
+ * WCharacter.h - Character utility functions for Wiring & Arduino
+ * Copyright (c) 2010 Hernando Barragan.  All right reserved.
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
  */
-
-#ifndef Character_h
-#define Character_h
+#ifndef CHARACTER_H
+#define CHARACTER_H
 
 #include <ctype.h>
 
@@ -41,131 +40,115 @@ inline bool isUpperCase(int c) __attribute__((always_inline));
 inline bool isHexadecimalDigit(int c) __attribute__((always_inline));
 inline int toAscii(int c) __attribute__((always_inline));
 inline int toLowerCase(int c) __attribute__((always_inline));
-inline int toUpperCase(int c)__attribute__((always_inline));
-
+inline int toUpperCase(int c) __attribute__((always_inline));
 
-// Checks for an alphanumeric character. 
+// Checks for an alphanumeric character.
 // It is equivalent to (isalpha(c) || isdigit(c)).
-inline bool isAlphaNumeric(int c) 
+inline bool isAlphaNumeric(int c)
 {
-  return ( isalnum(c) == 0 ? false : true);
+    return (isalnum(c) == 0 ? false : true);
 }
 
-
-// Checks for an alphabetic character. 
+// Checks for an alphabetic character.
 // It is equivalent to (isupper(c) || islower(c)).
 inline bool isAlpha(int c)
 {
-  return ( isalpha(c) == 0 ? false : true);
+    return (isalpha(c) == 0 ? false : true);
 }
 
-
-// Checks whether c is a 7-bit unsigned char value 
+// Checks whether c is a 7-bit unsigned char value
 // that fits into the ASCII character set.
 inline bool isAscii(int c)
 {
-  return ( isascii (c) == 0 ? false : true);
+    return (isascii(c) == 0 ? false : true);
 }
 
-
 // Checks for a blank character, that is, a space or a tab.
 inline bool isWhitespace(int c)
 {
-  return ( isblank (c) == 0 ? false : true);
+    return (isblank(c) == 0 ? false : true);
 }
 
-
 // Checks for a control character.
 inline bool isControl(int c)
 {
-  return ( iscntrl (c) == 0 ? false : true);
+    return (iscntrl(c) == 0 ? false : true);
 }
 
-
 // Checks for a digit (0 through 9).
 inline bool isDigit(int c)
 {
-  return ( isdigit (c) == 0 ? false : true);
+    return (isdigit(c) == 0 ? false : true);
 }
 
-
 // Checks for any printable character except space.
 inline bool isGraph(int c)
 {
-  return ( isgraph (c) == 0 ? false : true);
+    return (isgraph(c) == 0 ? false : true);
 }
 
-
 // Checks for a lower-case character.
 inline bool isLowerCase(int c)
 {
-  return (islower (c) == 0 ? false : true);
+    return (islower(c) == 0 ? false : true);
 }
 
-
 // Checks for any printable character including space.
 inline bool isPrintable(int c)
 {
-  return ( isprint (c) == 0 ? false : true);
+    return (isprint(c) == 0 ? false : true);
 }
 
-
-// Checks for any printable character which is not a space 
+// Checks for any printable character which is not a space
 // or an alphanumeric character.
 inline bool isPunct(int c)
 {
-  return ( ispunct (c) == 0 ? false : true);
+    return (ispunct(c) == 0 ? false : true);
 }
 
-
-// Checks for white-space characters. For the avr-libc library, 
-// these are: space, formfeed ('\f'), newline ('\n'), carriage 
+// Checks for white-space characters. For the avr-libc library,
+// these are: space, formfeed ('\f'), newline ('\n'), carriage
 // return ('\r'), horizontal tab ('\t'), and vertical tab ('\v').
 inline bool isSpace(int c)
 {
-  return ( isspace (c) == 0 ? false : true);
+    return (isspace(c) == 0 ? false : true);
 }
 
-
 // Checks for an uppercase letter.
 inline bool isUpperCase(int c)
 {
-  return ( isupper (c) == 0 ? false : true);
+    return (isupper(c) == 0 ? false : true);
 }
 
-
-// Checks for a hexadecimal digits, i.e. one of 0 1 2 3 4 5 6 7 
+// Checks for a hexadecimal digits, i.e. one of 0 1 2 3 4 5 6 7
 // 8 9 a b c d e f A B C D E F.
 inline bool isHexadecimalDigit(int c)
 {
-  return ( isxdigit (c) == 0 ? false : true);
+    return (isxdigit(c) == 0 ? false : true);
 }
 
-
-// Converts c to a 7-bit unsigned char value that fits into the 
+// Converts c to a 7-bit unsigned char value that fits into the
 // ASCII character set, by clearing the high-order bits.
 inline int toAscii(int c)
 {
-  return toascii (c);
+    return toascii(c);
 }
 
-
 // Warning:
-// Many people will be unhappy if you use this function. 
-// This function will convert accented letters into random 
+// Many people will be unhappy if you use this function.
+// This function will convert accented letters into random
 // characters.
 
 // Converts the letter c to lower case, if possible.
 inline int toLowerCase(int c)
 {
-  return tolower (c);
+    return tolower(c);
 }
 
-
 // Converts the letter c to upper case, if possible.
 inline int toUpperCase(int c)
 {
-  return toupper (c);
+    return toupper(c);
 }
 
 #endif

Keilduino/ArduinoAPI/WMath.cpp

@@ -20,13 +20,41 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  */
+
+/*********************
+ *      INCLUDES
+ *********************/
+
 #include "WMath.h"
 #include <stdlib.h>
 
+/*********************
+ *      DEFINES
+ *********************/
+
+/**********************
+ *      TYPEDEFS
+ **********************/
+
+/**********************
+ *  STATIC PROTOTYPES
+ **********************/
+
+/**********************
+ *  STATIC VARIABLES
+ **********************/
+
+/**********************
+ *      MACROS
+ **********************/
+
+/**********************
+ *   GLOBAL FUNCTIONS
+ **********************/
+
 void randomSeed(unsigned long seed)
 {
-    if (seed == 0)
-    {
+    if (seed == 0) {
         return;
     }
 
@@ -35,8 +63,7 @@ void randomSeed(unsigned long seed)
 
 long random(long howbig)
 {
-    if (howbig == 0)
-    {
+    if (howbig == 0) {
         return 0;
     }
 
@@ -45,21 +72,10 @@ long random(long howbig)
 
 long random(long howsmall, long howbig)
 {
-    if (howsmall >= howbig)
-    {
+    if (howsmall >= howbig) {
         return howsmall;
     }
 
     long diff = howbig - howsmall;
     return random(diff) + howsmall;
 }
-
-unsigned int makeWord(unsigned int w)
-{
-    return w;
-}
-
-unsigned int makeWord(unsigned char h, unsigned char l)
-{
-    return (h << 8) | l;
-}

Keilduino/ArduinoAPI/WMath.h

@@ -1,6 +1,6 @@
 /*
  * MIT License
- * Copyright (c) 2017 - 2022 _VIFEXTech
+ * Copyright (c) 2017 - 2025 _VIFEXTech
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -20,13 +20,65 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  */
-#ifndef __WMATH_H
-#define __WMATH_H
+#ifndef WMATH_H
+#define WMATH_H
 
+/*********************
+ *      INCLUDES
+ *********************/
+
+/*********************
+ *      DEFINES
+ *********************/
+
+/**********************
+ *      TYPEDEFS
+ **********************/
+
+/**********************
+ * GLOBAL PROTOTYPES
+ **********************/
+
+/**
+ * @brief  Seed the random number generator with a specific seed value.
+ * @param  seed  The seed value to initialize the random number generator.
+ */
 void randomSeed(unsigned long seed);
+
+/**
+ * @brief  Generate a random number between 0 and the specified maximum value.
+ * @param  howbig  The upper limit for the random number (exclusive).
+ * @return A random number between 0 and howbig - 1.
+ */
 long random(long howbig);
+
+/**
+ * @brief  Generate a random number between the specified minimum and maximum values.
+ * @param  howsmall  The lower limit for the random number (inclusive).
+ * @param  howbig    The upper limit for the random number (exclusive).
+ * @return A random number between howsmall and howbig - 1.
+ */
 long random(long howsmall, long howbig);
-unsigned int makeWord(unsigned int w);
-unsigned int makeWord(unsigned char h, unsigned char l);
 
-#endif
+/**
+ * @brief  Create a word (16-bit value) from a single unsigned integer.
+ * @param  w  The unsigned integer to convert to a word.
+ * @return The word created from the input integer.
+ */
+static inline unsigned int makeWord(unsigned int w)
+{
+    return w;
+}
+
+/**
+ * @brief  Create a word (16-bit value) from two unsigned char values.
+ * @param  h  The high byte of the word.
+ * @param  l  The low byte of the word.
+ * @return The word created from the input bytes.
+ */
+static inline unsigned int makeWord(unsigned char h, unsigned char l)
+{
+    return (h << 8) | l;
+}
+
+#endif /* WMATH_H */

Keilduino/ArduinoAPI/WProgram.h

@@ -1,6 +1,32 @@
-#ifndef __WPROGRAM_H
-#define	__WPROGRAM_H
+/*
+ * MIT License
+ * Copyright (c) 2017 - 2025 _VIFEXTech
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+#ifndef WPROGRAM_H
+#define WPROGRAM_H
+
+/*********************
+ *      INCLUDES
+ *********************/
 
 #include "Arduino.h"
 
-#endif
+#endif /* WPROGRAM_H */