《jdk8u源码分析》jli_util.h

C语言参考教程

src/share/bin/jli_util.h

/*
 * Copyright (c) 2005, 2014, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.  Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the LICENSE file that accompanied this code.
 *
 * This code 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 General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 */

#ifndef _JLI_UTIL_H
#define _JLI_UTIL_H

#include <stdlib.h>
#include <string.h>
#include <stdio.h>
#include <jni.h>
#define JLDEBUG_ENV_ENTRY "_JAVA_LAUNCHER_DEBUG"

void *JLI_MemAlloc(size_t size);
void *JLI_MemRealloc(void *ptr, size_t size);
char *JLI_StringDup(const char *s1);
void  JLI_MemFree(void *ptr);
int   JLI_StrCCmp(const char *s1, const char* s2);

typedef struct {
    char *arg;
    jboolean has_wildcard;
} StdArg;

StdArg *JLI_GetStdArgs();
int     JLI_GetStdArgc();

//size_t strlen(const char *str)
//计算字符串 str 的长度，直到空结束字符，但不包括空结束字符。
#define JLI_StrLen(p1)          strlen((p1))
//char *strchr(const char *str, int c)
//在参数 str 所指向的字符串中搜索第一次出现字符 c（一个无符号字符）的位置。				
#define JLI_StrChr(p1, p2)      strchr((p1), (p2))
//char *strrchr(const char *str, int c)
//在参数 str 所指向的字符串中搜索最后一次出现字符 c（一个无符号字符）的位置。	
#define JLI_StrRChr(p1, p2)     strrchr((p1), (p2))
//int strcmp(const char *str1, const char *str2)
//把 str1 所指向的字符串和 str2 所指向的字符串进行比较。区分大小写
//两个字符串的每个字符从左到右依此按照对应的ascii码值大小进行比较，
//若两字符对应的ascii码值相等，继续比较直到出现不同的字符或者遇到串尾标志符'\0'为止。
#define JLI_StrCmp(p1, p2)      strcmp((p1), (p2))
//int strncmp(const char *str1, const char *str2, size_t n)
//把 str1 和 str2 进行比较，最多比较前 n 个字节。
#define JLI_StrNCmp(p1, p2, p3) strncmp((p1), (p2), (p3))
//char *strcat(char *dest, const char *src)
//把 src 所指向的字符串追加到 dest 所指向的字符串的结尾。
#define JLI_StrCat(p1, p2)      strcat((p1), (p2))
//char *strcpy(char *dest, const char *src)
//把 src 所指向的字符串复制到 dest。
#define JLI_StrCpy(p1, p2)      strcpy((p1), (p2))
//char *strncpy(char *dest, const char *src, size_t n)
//把 src 所指向的字符串复制到 dest，最多复制 n 个字符。
#define JLI_StrNCpy(p1, p2, p3) strncpy((p1), (p2), (p3))
//char *strstr(const char *haystack, const char *needle)
//在字符串 haystack 中查找第一次出现字符串 needle（不包含空结束字符）的位置。
#define JLI_StrStr(p1, p2)      strstr((p1), (p2))
//size_t strspn(const char *str1, const char *str2)
//检索字符串 str1 中第一个不在字符串 str2 中出现的字符下标。
//从参数 str1 字符串的开头计算**连续**的字符，而这些字符都完全是 accept 所指字符串中的字符。
//简单的说，若 strspn() 返回的数值为n，则代表字符串 str 开头连续有 n 个字符都是属于字符串 accept 内的字符。
#define JLI_StrSpn(p1, p2)      strspn((p1), (p2))
//size_t strcspn(const char *str1, const char *str2)
//检索字符串 str1 开头连续有几个字符都不含字符串 str2 中的字符。
#define JLI_StrCSpn(p1, p2)     strcspn((p1), (p2))
//char *strpbrk(const char *str1, const char *str2)
//检索字符串 str1 中第一个匹配字符串 str2 中字符的字符，不包含空结束字符。
//也就是说，依次检验字符串 str1 中的字符，当被检验字符在字符串 str2 中也包含时，则停止检验，并返回该字符位置。
#define JLI_StrPBrk(p1, p2)     strpbrk((p1), (p2))
//char *strtok(char *str, const char *delim)
//分解字符串 str 为一组字符串，delim 为分隔符。
#define JLI_StrTok(p1, p2)      strtok((p1), (p2))

/* On Windows lseek() is in io.h rather than the location dictated by POSIX. */
#ifdef _WIN32
#include <windows.h>
#include <io.h>
#include <process.h>
//比较字符串p1，p2，不区分大小写
#define JLI_StrCaseCmp(p1, p2)          stricmp((p1), (p2))
//比较字符串p1，p2，最多比较前p3个字节，不区分大小写
#define JLI_StrNCaseCmp(p1, p2, p3)     strnicmp((p1), (p2), (p3))
int  JLI_Snprintf(char *buffer, size_t size, const char *format, ...);
void JLI_CmdToArgs(char *cmdline);
//_lseeki64(fd, pos, SEEK_SET) 从文件开头移动pos位置,并返回在64位整数的偏移量
#define JLI_Lseek                       _lseeki64
//int _putenv(const char *envstring)
//创建一个新的环境变量，以及修改或删除一个已存在的环境变量。对环境变量名称的大小写不敏感。
//执行成功则返回0, 有错误发生则返回-1.
#define JLI_PutEnv                      _putenv
//int _getpid(void) 用来取得目前进程的进程ID
#define JLI_GetPid                      _getpid
#else  /* NIXES */
#include <unistd.h>
#include <strings.h>
//比较字符串p1，p2，不区分大小写
#define JLI_StrCaseCmp(p1, p2)          strcasecmp((p1), (p2))
//比较字符串p1，p2，最多比较前p3个字节，不区分大小写
#define JLI_StrNCaseCmp(p1, p2, p3)     strncasecmp((p1), (p2), (p3))
//int snprintf(char *str, size_t size, const char *format, ...)
//将可变参数 “…” 按照format的格式格式化为字符串，然后再将其拷贝至str中。
#define JLI_Snprintf                    snprintf
//int putenv(char *envvar)
//用来改变或增加环境变量的内容。参数envvar的格式为envvar=value，如果该环境变量原先存在，则变量内容会依参数envvar改变，否则此参数内容会成为新的环境变量。
#define JLI_PutEnv                      putenv
//pid_t getpid(void)
//用来取得目前进程的进程ID，许多程序利用取到的此值来建立临时文件，以避免临时文件相同带来的问题。
#define JLI_GetPid                      getpid
//off_t lseek(int fd, off_t offset, int whence)
//重新定位读/写文件偏移量，fd是要操作的文件描述符，offset指定文件操作指针的偏移量（读和写使用的是同一个文件操作指针）
//whence指定移动文件操作指针的参考点。这个参数通常取值为以下宏：
//SEEK_SET：表示相对文件起始位置。
//SEEK_CUR：表示相对文件操作指针当前位置。
//SEEK_END：表示相对文件结束位置。
#ifdef __solaris__
#define JLI_Lseek                       llseek							
#endif
#ifdef __linux__
#define _LARGFILE64_SOURCE
//lseek64是_llseek的包装函数，可以简便的在代码中完成跳转。不过在使用前需要定义宏_LARGEFILE64_SOURCE
#define JLI_Lseek                       lseek64
#endif
#ifdef MACOSX
#define JLI_Lseek                       lseek
#endif
#ifdef _AIX
#define JLI_Lseek                       lseek
#endif
#endif /* _WIN32 */

/*
 * Make launcher spit debug output.
 */
void     JLI_TraceLauncher(const char* fmt, ...);
void     JLI_SetTraceLauncher();
jboolean JLI_IsTraceLauncher();

#endif  /* _JLI_UTIL_H */